<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.13.2"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>CAD_Doc: Build/_deps/googletest-src/googlemock/include/gmock/gmock-spec-builders.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<script type="text/javascript" src="clipboard.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="cookie.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  $(function() { init_search(); });
/* @license-end */
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr id="projectrow">
  <td id="projectalign">
   <div id="projectname">CAD_Doc<span id="projectnumber">&#160;1.0</span>
   </div>
   <div id="projectbrief">cad synopsis</div>
  </td>
    <td>        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
          <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
          </span>
        </div>
</td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.13.2 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search/",'.html');
/* @license-end */
</script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() { codefold.init(0); });
/* @license-end */
</script>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
      <div id="nav-sync" class="sync"></div>
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function(){initNavTree('gmock-spec-builders_8h_source.html',''); initResizable(true); });
/* @license-end */
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<div id="MSearchResults">
<div class="SRPage">
<div id="SRIndex">
<div id="SRResults"></div>
<div class="SRStatus" id="Loading">Loading...</div>
<div class="SRStatus" id="Searching">Searching...</div>
<div class="SRStatus" id="NoMatches">No Matches</div>
</div>
</div>
</div>
</div>

<div class="header">
  <div class="headertitle"><div class="title">gmock-spec-builders.h</div></div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">// Copyright 2007, Google Inc.</span></div>
<div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment">// All rights reserved.</span></div>
<div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">//</span></div>
<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">// Redistribution and use in source and binary forms, with or without</span></div>
<div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment">// modification, are permitted provided that the following conditions are</span></div>
<div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment">// met:</span></div>
<div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">//</span></div>
<div class="line"><a id="l00008" name="l00008"></a><span class="lineno">    8</span><span class="comment">//     * Redistributions of source code must retain the above copyright</span></div>
<div class="line"><a id="l00009" name="l00009"></a><span class="lineno">    9</span><span class="comment">// notice, this list of conditions and the following disclaimer.</span></div>
<div class="line"><a id="l00010" name="l00010"></a><span class="lineno">   10</span><span class="comment">//     * Redistributions in binary form must reproduce the above</span></div>
<div class="line"><a id="l00011" name="l00011"></a><span class="lineno">   11</span><span class="comment">// copyright notice, this list of conditions and the following disclaimer</span></div>
<div class="line"><a id="l00012" name="l00012"></a><span class="lineno">   12</span><span class="comment">// in the documentation and/or other materials provided with the</span></div>
<div class="line"><a id="l00013" name="l00013"></a><span class="lineno">   13</span><span class="comment">// distribution.</span></div>
<div class="line"><a id="l00014" name="l00014"></a><span class="lineno">   14</span><span class="comment">//     * Neither the name of Google Inc. nor the names of its</span></div>
<div class="line"><a id="l00015" name="l00015"></a><span class="lineno">   15</span><span class="comment">// contributors may be used to endorse or promote products derived from</span></div>
<div class="line"><a id="l00016" name="l00016"></a><span class="lineno">   16</span><span class="comment">// this software without specific prior written permission.</span></div>
<div class="line"><a id="l00017" name="l00017"></a><span class="lineno">   17</span><span class="comment">//</span></div>
<div class="line"><a id="l00018" name="l00018"></a><span class="lineno">   18</span><span class="comment">// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</span></div>
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno">   19</span><span class="comment">// &quot;AS IS&quot; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</span></div>
<div class="line"><a id="l00020" name="l00020"></a><span class="lineno">   20</span><span class="comment">// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</span></div>
<div class="line"><a id="l00021" name="l00021"></a><span class="lineno">   21</span><span class="comment">// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT</span></div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno">   22</span><span class="comment">// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</span></div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno">   23</span><span class="comment">// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT</span></div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno">   24</span><span class="comment">// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,</span></div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno">   25</span><span class="comment">// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY</span></div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno">   26</span><span class="comment">// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</span></div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno">   27</span><span class="comment">// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE</span></div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno">   28</span><span class="comment">// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span></div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno">   29</span> </div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno">   30</span><span class="comment">// Google Mock - a framework for writing C++ mock classes.</span></div>
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno">   31</span><span class="comment">//</span></div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno">   32</span><span class="comment">// This file implements the ON_CALL() and EXPECT_CALL() macros.</span></div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno">   33</span><span class="comment">//</span></div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno">   34</span><span class="comment">// A user can use the ON_CALL() macro to specify the default action of</span></div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno">   35</span><span class="comment">// a mock method.  The syntax is:</span></div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno">   36</span><span class="comment">//</span></div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno">   37</span><span class="comment">//   ON_CALL(mock_object, Method(argument-matchers))</span></div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno">   38</span><span class="comment">//       .With(multi-argument-matcher)</span></div>
<div class="line"><a id="l00039" name="l00039"></a><span class="lineno">   39</span><span class="comment">//       .WillByDefault(action);</span></div>
<div class="line"><a id="l00040" name="l00040"></a><span class="lineno">   40</span><span class="comment">//</span></div>
<div class="line"><a id="l00041" name="l00041"></a><span class="lineno">   41</span><span class="comment">//  where the .With() clause is optional.</span></div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno">   42</span><span class="comment">//</span></div>
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno">   43</span><span class="comment">// A user can use the EXPECT_CALL() macro to specify an expectation on</span></div>
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno">   44</span><span class="comment">// a mock method.  The syntax is:</span></div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno">   45</span><span class="comment">//</span></div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno">   46</span><span class="comment">//   EXPECT_CALL(mock_object, Method(argument-matchers))</span></div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno">   47</span><span class="comment">//       .With(multi-argument-matchers)</span></div>
<div class="line"><a id="l00048" name="l00048"></a><span class="lineno">   48</span><span class="comment">//       .Times(cardinality)</span></div>
<div class="line"><a id="l00049" name="l00049"></a><span class="lineno">   49</span><span class="comment">//       .InSequence(sequences)</span></div>
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno">   50</span><span class="comment">//       .After(expectations)</span></div>
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno">   51</span><span class="comment">//       .WillOnce(action)</span></div>
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno">   52</span><span class="comment">//       .WillRepeatedly(action)</span></div>
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno">   53</span><span class="comment">//       .RetiresOnSaturation();</span></div>
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno">   54</span><span class="comment">//</span></div>
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno">   55</span><span class="comment">// where all clauses are optional, and .InSequence()/.After()/</span></div>
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno">   56</span><span class="comment">// .WillOnce() can appear any number of times.</span></div>
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno">   57</span> </div>
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno">   58</span><span class="comment">// IWYU pragma: private, include &quot;gmock/gmock.h&quot;</span></div>
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno">   59</span><span class="comment">// IWYU pragma: friend gmock/.*</span></div>
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno">   60</span> </div>
<div class="line"><a id="l00061" name="l00061"></a><span class="lineno">   61</span><span class="preprocessor">#ifndef GOOGLEMOCK_INCLUDE_GMOCK_GMOCK_SPEC_BUILDERS_H_</span></div>
<div class="line"><a id="l00062" name="l00062"></a><span class="lineno">   62</span><span class="preprocessor">#define GOOGLEMOCK_INCLUDE_GMOCK_GMOCK_SPEC_BUILDERS_H_</span></div>
<div class="line"><a id="l00063" name="l00063"></a><span class="lineno">   63</span> </div>
<div class="line"><a id="l00064" name="l00064"></a><span class="lineno">   64</span><span class="preprocessor">#include &lt;cstdint&gt;</span></div>
<div class="line"><a id="l00065" name="l00065"></a><span class="lineno">   65</span><span class="preprocessor">#include &lt;functional&gt;</span></div>
<div class="line"><a id="l00066" name="l00066"></a><span class="lineno">   66</span><span class="preprocessor">#include &lt;map&gt;</span></div>
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno">   67</span><span class="preprocessor">#include &lt;memory&gt;</span></div>
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno">   68</span><span class="preprocessor">#include &lt;set&gt;</span></div>
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno">   69</span><span class="preprocessor">#include &lt;sstream&gt;</span></div>
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno">   70</span><span class="preprocessor">#include &lt;string&gt;</span></div>
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno">   71</span><span class="preprocessor">#include &lt;type_traits&gt;</span></div>
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno">   72</span><span class="preprocessor">#include &lt;utility&gt;</span></div>
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno">   73</span><span class="preprocessor">#include &lt;vector&gt;</span></div>
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno">   74</span> </div>
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno">   75</span><span class="preprocessor">#include &quot;gmock/gmock-actions.h&quot;</span></div>
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno">   76</span><span class="preprocessor">#include &quot;gmock/gmock-cardinalities.h&quot;</span></div>
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno">   77</span><span class="preprocessor">#include &quot;gmock/gmock-matchers.h&quot;</span></div>
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno">   78</span><span class="preprocessor">#include &quot;gmock/internal/gmock-internal-utils.h&quot;</span></div>
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno">   79</span><span class="preprocessor">#include &quot;gmock/internal/gmock-port.h&quot;</span></div>
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno">   80</span><span class="preprocessor">#include &quot;gtest/gtest.h&quot;</span></div>
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno">   81</span> </div>
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno">   82</span><span class="preprocessor">#if GTEST_HAS_EXCEPTIONS</span></div>
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno">   83</span><span class="preprocessor">#include &lt;stdexcept&gt;</span>  <span class="comment">// NOLINT</span></div>
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno">   84</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno">   85</span> </div>
<div class="line"><a id="l00086" name="l00086"></a><span class="lineno">   86</span>GTEST_DISABLE_MSC_WARNINGS_PUSH_(4251 \</div>
<div class="line"><a id="l00087" name="l00087"></a><span class="lineno">   87</span><span class="comment">/* class A needs to have dll-interface to be used by clients of class B */</span>)</div>
<div class="line"><a id="l00088" name="l00088"></a><span class="lineno">   88</span> </div>
<div class="line"><a id="l00089" name="l00089"></a><span class="lineno">   89</span>namespace testing {</div>
<div class="line"><a id="l00090" name="l00090"></a><span class="lineno">   90</span> </div>
<div class="line"><a id="l00091" name="l00091"></a><span class="lineno">   91</span><span class="comment">// An abstract handle of an expectation.</span></div>
<div class="line"><a id="l00092" name="l00092"></a><span class="lineno">   92</span><span class="keyword">class </span>Expectation;</div>
<div class="line"><a id="l00093" name="l00093"></a><span class="lineno">   93</span> </div>
<div class="line"><a id="l00094" name="l00094"></a><span class="lineno">   94</span><span class="comment">// A set of expectation handles.</span></div>
<div class="line"><a id="l00095" name="l00095"></a><span class="lineno">   95</span><span class="keyword">class </span>ExpectationSet;</div>
<div class="line"><a id="l00096" name="l00096"></a><span class="lineno">   96</span> </div>
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno">   97</span><span class="comment">// Anything inside the &#39;internal&#39; namespace IS INTERNAL IMPLEMENTATION</span></div>
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno">   98</span><span class="comment">// and MUST NOT BE USED IN USER CODE!!!</span></div>
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno">   99</span><span class="keyword">namespace </span>internal {</div>
<div class="line"><a id="l00100" name="l00100"></a><span class="lineno">  100</span> </div>
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno">  101</span><span class="comment">// Implements a mock function.</span></div>
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno">  102</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno">  103</span><span class="keyword">class </span>FunctionMocker;</div>
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno">  104</span> </div>
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno">  105</span><span class="comment">// Base class for expectations.</span></div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno">  106</span><span class="keyword">class </span>ExpectationBase;</div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno">  107</span> </div>
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno">  108</span><span class="comment">// Implements an expectation.</span></div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno">  109</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno">  110</span><span class="keyword">class </span>TypedExpectation;</div>
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno">  111</span> </div>
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno">  112</span><span class="comment">// Helper class for testing the Expectation class template.</span></div>
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno">  113</span><span class="keyword">class </span>ExpectationTester;</div>
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno">  114</span> </div>
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno">  115</span><span class="comment">// Helper classes for implementing NiceMock, StrictMock, and NaggyMock.</span></div>
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno">  116</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> MockClass&gt;</div>
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno">  117</span><span class="keyword">class </span>NiceMockImpl;</div>
<div class="line"><a id="l00118" name="l00118"></a><span class="lineno">  118</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> MockClass&gt;</div>
<div class="line"><a id="l00119" name="l00119"></a><span class="lineno">  119</span><span class="keyword">class </span>StrictMockImpl;</div>
<div class="line"><a id="l00120" name="l00120"></a><span class="lineno">  120</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> MockClass&gt;</div>
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno">  121</span><span class="keyword">class </span>NaggyMockImpl;</div>
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno">  122</span> </div>
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno">  123</span><span class="comment">// Protects the mock object registry (in class Mock), all function</span></div>
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno">  124</span><span class="comment">// mockers, and all expectations.</span></div>
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno">  125</span><span class="comment">//</span></div>
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno">  126</span><span class="comment">// The reason we don&#39;t use more fine-grained protection is: when a</span></div>
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno">  127</span><span class="comment">// mock function Foo() is called, it needs to consult its expectations</span></div>
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno">  128</span><span class="comment">// to see which one should be picked.  If another thread is allowed to</span></div>
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno">  129</span><span class="comment">// call a mock function (either Foo() or a different one) at the same</span></div>
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno">  130</span><span class="comment">// time, it could affect the &quot;retired&quot; attributes of Foo()&#39;s</span></div>
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno">  131</span><span class="comment">// expectations when InSequence() is used, and thus affect which</span></div>
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno">  132</span><span class="comment">// expectation gets picked.  Therefore, we sequence all mock function</span></div>
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno">  133</span><span class="comment">// calls to ensure the integrity of the mock objects&#39; states.</span></div>
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno">  134</span>GTEST_API_ GTEST_DECLARE_STATIC_MUTEX_(g_gmock_mutex);</div>
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno">  135</span> </div>
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno">  136</span><span class="comment">// Abstract base class of FunctionMocker.  This is the</span></div>
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno">  137</span><span class="comment">// type-agnostic part of the function mocker interface.  Its pure</span></div>
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno">  138</span><span class="comment">// virtual methods are implemented by FunctionMocker.</span></div>
<div class="line"><a id="l00139" name="l00139"></a><span class="lineno">  139</span><span class="keyword">class </span>GTEST_API_ UntypedFunctionMockerBase {</div>
<div class="line"><a id="l00140" name="l00140"></a><span class="lineno">  140</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00141" name="l00141"></a><span class="lineno">  141</span>  UntypedFunctionMockerBase();</div>
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno">  142</span>  <span class="keyword">virtual</span> ~UntypedFunctionMockerBase();</div>
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno">  143</span> </div>
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno">  144</span>  <span class="comment">// Verifies that all expectations on this mock function have been</span></div>
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno">  145</span>  <span class="comment">// satisfied.  Reports one or more Google Test non-fatal failures</span></div>
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno">  146</span>  <span class="comment">// and returns false if not.</span></div>
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno">  147</span>  <span class="keywordtype">bool</span> VerifyAndClearExpectationsLocked()</div>
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno">  148</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex);</div>
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno">  149</span> </div>
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno">  150</span>  <span class="comment">// Clears the ON_CALL()s set on this mock function.</span></div>
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno">  151</span>  virtual <span class="keywordtype">void</span> ClearDefaultActionsLocked()</div>
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno">  152</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) = 0;</div>
<div class="line"><a id="l00153" name="l00153"></a><span class="lineno">  153</span> </div>
<div class="line"><a id="l00154" name="l00154"></a><span class="lineno">  154</span>  <span class="comment">// In all of the following Untyped* functions, it&#39;s the caller&#39;s</span></div>
<div class="line"><a id="l00155" name="l00155"></a><span class="lineno">  155</span>  <span class="comment">// responsibility to guarantee the correctness of the arguments&#39;</span></div>
<div class="line"><a id="l00156" name="l00156"></a><span class="lineno">  156</span>  <span class="comment">// types.</span></div>
<div class="line"><a id="l00157" name="l00157"></a><span class="lineno">  157</span> </div>
<div class="line"><a id="l00158" name="l00158"></a><span class="lineno">  158</span>  <span class="comment">// Writes a message that the call is uninteresting (i.e. neither</span></div>
<div class="line"><a id="l00159" name="l00159"></a><span class="lineno">  159</span>  <span class="comment">// explicitly expected nor explicitly unexpected) to the given</span></div>
<div class="line"><a id="l00160" name="l00160"></a><span class="lineno">  160</span>  <span class="comment">// ostream.</span></div>
<div class="line"><a id="l00161" name="l00161"></a><span class="lineno">  161</span>  virtual <span class="keywordtype">void</span> UntypedDescribeUninterestingCall(const <span class="keywordtype">void</span>* untyped_args,</div>
<div class="line"><a id="l00162" name="l00162"></a><span class="lineno">  162</span>                                                ::std::ostream* os) const</div>
<div class="line"><a id="l00163" name="l00163"></a><span class="lineno">  163</span>      GTEST_LOCK_EXCLUDED_(g_gmock_mutex) = 0;</div>
<div class="line"><a id="l00164" name="l00164"></a><span class="lineno">  164</span> </div>
<div class="line"><a id="l00165" name="l00165"></a><span class="lineno">  165</span>  <span class="comment">// Returns the expectation that matches the given function arguments</span></div>
<div class="line"><a id="l00166" name="l00166"></a><span class="lineno">  166</span>  <span class="comment">// (or NULL is there&#39;s no match); when a match is found,</span></div>
<div class="line"><a id="l00167" name="l00167"></a><span class="lineno">  167</span>  <span class="comment">// untyped_action is set to point to the action that should be</span></div>
<div class="line"><a id="l00168" name="l00168"></a><span class="lineno">  168</span>  <span class="comment">// performed (or NULL if the action is &quot;do default&quot;), and</span></div>
<div class="line"><a id="l00169" name="l00169"></a><span class="lineno">  169</span>  <span class="comment">// is_excessive is modified to indicate whether the call exceeds the</span></div>
<div class="line"><a id="l00170" name="l00170"></a><span class="lineno">  170</span>  <span class="comment">// expected number.</span></div>
<div class="line"><a id="l00171" name="l00171"></a><span class="lineno">  171</span>  virtual const ExpectationBase* UntypedFindMatchingExpectation(</div>
<div class="line"><a id="l00172" name="l00172"></a><span class="lineno">  172</span>      const <span class="keywordtype">void</span>* untyped_args, const <span class="keywordtype">void</span>** untyped_action, <span class="keywordtype">bool</span>* is_excessive,</div>
<div class="line"><a id="l00173" name="l00173"></a><span class="lineno">  173</span>      ::std::ostream* what, ::std::ostream* why)</div>
<div class="line"><a id="l00174" name="l00174"></a><span class="lineno">  174</span>      GTEST_LOCK_EXCLUDED_(g_gmock_mutex) = 0;</div>
<div class="line"><a id="l00175" name="l00175"></a><span class="lineno">  175</span> </div>
<div class="line"><a id="l00176" name="l00176"></a><span class="lineno">  176</span>  <span class="comment">// Prints the given function arguments to the ostream.</span></div>
<div class="line"><a id="l00177" name="l00177"></a><span class="lineno">  177</span>  virtual <span class="keywordtype">void</span> UntypedPrintArgs(const <span class="keywordtype">void</span>* untyped_args,</div>
<div class="line"><a id="l00178" name="l00178"></a><span class="lineno">  178</span>                                ::std::ostream* os) const = 0;</div>
<div class="line"><a id="l00179" name="l00179"></a><span class="lineno">  179</span> </div>
<div class="line"><a id="l00180" name="l00180"></a><span class="lineno">  180</span>  <span class="comment">// Sets the mock object this mock method belongs to, and registers</span></div>
<div class="line"><a id="l00181" name="l00181"></a><span class="lineno">  181</span>  <span class="comment">// this information in the global mock registry.  Will be called</span></div>
<div class="line"><a id="l00182" name="l00182"></a><span class="lineno">  182</span>  <span class="comment">// whenever an EXPECT_CALL() or ON_CALL() is executed on this mock</span></div>
<div class="line"><a id="l00183" name="l00183"></a><span class="lineno">  183</span>  <span class="comment">// method.</span></div>
<div class="line"><a id="l00184" name="l00184"></a><span class="lineno">  184</span>  <span class="keywordtype">void</span> RegisterOwner(const <span class="keywordtype">void</span>* mock_obj) GTEST_LOCK_EXCLUDED_(g_gmock_mutex);</div>
<div class="line"><a id="l00185" name="l00185"></a><span class="lineno">  185</span> </div>
<div class="line"><a id="l00186" name="l00186"></a><span class="lineno">  186</span>  <span class="comment">// Sets the mock object this mock method belongs to, and sets the</span></div>
<div class="line"><a id="l00187" name="l00187"></a><span class="lineno">  187</span>  <span class="comment">// name of the mock function.  Will be called upon each invocation</span></div>
<div class="line"><a id="l00188" name="l00188"></a><span class="lineno">  188</span>  <span class="comment">// of this mock function.</span></div>
<div class="line"><a id="l00189" name="l00189"></a><span class="lineno">  189</span>  <span class="keywordtype">void</span> SetOwnerAndName(const <span class="keywordtype">void</span>* mock_obj, const <span class="keywordtype">char</span>* name)</div>
<div class="line"><a id="l00190" name="l00190"></a><span class="lineno">  190</span>      GTEST_LOCK_EXCLUDED_(g_gmock_mutex);</div>
<div class="line"><a id="l00191" name="l00191"></a><span class="lineno">  191</span> </div>
<div class="line"><a id="l00192" name="l00192"></a><span class="lineno">  192</span>  <span class="comment">// Returns the mock object this mock method belongs to.  Must be</span></div>
<div class="line"><a id="l00193" name="l00193"></a><span class="lineno">  193</span>  <span class="comment">// called after RegisterOwner() or SetOwnerAndName() has been</span></div>
<div class="line"><a id="l00194" name="l00194"></a><span class="lineno">  194</span>  <span class="comment">// called.</span></div>
<div class="line"><a id="l00195" name="l00195"></a><span class="lineno">  195</span>  const <span class="keywordtype">void</span>* MockObject() const GTEST_LOCK_EXCLUDED_(g_gmock_mutex);</div>
<div class="line"><a id="l00196" name="l00196"></a><span class="lineno">  196</span> </div>
<div class="line"><a id="l00197" name="l00197"></a><span class="lineno">  197</span>  <span class="comment">// Returns the name of this mock method.  Must be called after</span></div>
<div class="line"><a id="l00198" name="l00198"></a><span class="lineno">  198</span>  <span class="comment">// SetOwnerAndName() has been called.</span></div>
<div class="line"><a id="l00199" name="l00199"></a><span class="lineno">  199</span>  const <span class="keywordtype">char</span>* Name() const GTEST_LOCK_EXCLUDED_(g_gmock_mutex);</div>
<div class="line"><a id="l00200" name="l00200"></a><span class="lineno">  200</span> </div>
<div class="line"><a id="l00201" name="l00201"></a><span class="lineno">  201</span> protected:</div>
<div class="line"><a id="l00202" name="l00202"></a><span class="lineno">  202</span>  typedef std::vector&lt;const <span class="keywordtype">void</span>*&gt; UntypedOnCallSpecs;</div>
<div class="line"><a id="l00203" name="l00203"></a><span class="lineno">  203</span> </div>
<div class="line"><a id="l00204" name="l00204"></a><span class="lineno">  204</span>  using UntypedExpectations = std::vector&lt;std::shared_ptr&lt;ExpectationBase&gt;&gt;;</div>
<div class="line"><a id="l00205" name="l00205"></a><span class="lineno">  205</span> </div>
<div class="line"><a id="l00206" name="l00206"></a><span class="lineno">  206</span>  <span class="comment">// Returns an Expectation object that references and co-owns exp,</span></div>
<div class="line"><a id="l00207" name="l00207"></a><span class="lineno">  207</span>  <span class="comment">// which must be an expectation on this mock function.</span></div>
<div class="line"><a id="l00208" name="l00208"></a><span class="lineno">  208</span>  Expectation GetHandleOf(ExpectationBase* exp);</div>
<div class="line"><a id="l00209" name="l00209"></a><span class="lineno">  209</span> </div>
<div class="line"><a id="l00210" name="l00210"></a><span class="lineno">  210</span>  <span class="comment">// Address of the mock object this mock method belongs to.  Only</span></div>
<div class="line"><a id="l00211" name="l00211"></a><span class="lineno">  211</span>  <span class="comment">// valid after this mock method has been called or</span></div>
<div class="line"><a id="l00212" name="l00212"></a><span class="lineno">  212</span>  <span class="comment">// ON_CALL/EXPECT_CALL has been invoked on it.</span></div>
<div class="line"><a id="l00213" name="l00213"></a><span class="lineno">  213</span>  const <span class="keywordtype">void</span>* mock_obj_;  <span class="comment">// Protected by g_gmock_mutex.</span></div>
<div class="line"><a id="l00214" name="l00214"></a><span class="lineno">  214</span> </div>
<div class="line"><a id="l00215" name="l00215"></a><span class="lineno">  215</span>  <span class="comment">// Name of the function being mocked.  Only valid after this mock</span></div>
<div class="line"><a id="l00216" name="l00216"></a><span class="lineno">  216</span>  <span class="comment">// method has been called.</span></div>
<div class="line"><a id="l00217" name="l00217"></a><span class="lineno">  217</span>  const <span class="keywordtype">char</span>* name_;  <span class="comment">// Protected by g_gmock_mutex.</span></div>
<div class="line"><a id="l00218" name="l00218"></a><span class="lineno">  218</span> </div>
<div class="line"><a id="l00219" name="l00219"></a><span class="lineno">  219</span>  <span class="comment">// All default action specs for this function mocker.</span></div>
<div class="line"><a id="l00220" name="l00220"></a><span class="lineno">  220</span>  UntypedOnCallSpecs untyped_on_call_specs_;</div>
<div class="line"><a id="l00221" name="l00221"></a><span class="lineno">  221</span> </div>
<div class="line"><a id="l00222" name="l00222"></a><span class="lineno">  222</span>  <span class="comment">// All expectations for this function mocker.</span></div>
<div class="line"><a id="l00223" name="l00223"></a><span class="lineno">  223</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00224" name="l00224"></a><span class="lineno">  224</span>  <span class="comment">// It&#39;s undefined behavior to interleave expectations (EXPECT_CALLs</span></div>
<div class="line"><a id="l00225" name="l00225"></a><span class="lineno">  225</span>  <span class="comment">// or ON_CALLs) and mock function calls.  Also, the order of</span></div>
<div class="line"><a id="l00226" name="l00226"></a><span class="lineno">  226</span>  <span class="comment">// expectations is important.  Therefore it&#39;s a logic race condition</span></div>
<div class="line"><a id="l00227" name="l00227"></a><span class="lineno">  227</span>  <span class="comment">// to read/write untyped_expectations_ concurrently.  In order for</span></div>
<div class="line"><a id="l00228" name="l00228"></a><span class="lineno">  228</span>  <span class="comment">// tools like tsan to catch concurrent read/write accesses to</span></div>
<div class="line"><a id="l00229" name="l00229"></a><span class="lineno">  229</span>  <span class="comment">// untyped_expectations, we deliberately leave accesses to it</span></div>
<div class="line"><a id="l00230" name="l00230"></a><span class="lineno">  230</span>  <span class="comment">// unprotected.</span></div>
<div class="line"><a id="l00231" name="l00231"></a><span class="lineno">  231</span>  UntypedExpectations untyped_expectations_;</div>
<div class="line"><a id="l00232" name="l00232"></a><span class="lineno">  232</span>};  <span class="comment">// class UntypedFunctionMockerBase</span></div>
<div class="line"><a id="l00233" name="l00233"></a><span class="lineno">  233</span> </div>
<div class="line"><a id="l00234" name="l00234"></a><span class="lineno">  234</span><span class="comment">// Untyped base class for OnCallSpec&lt;F&gt;.</span></div>
<div class="line"><a id="l00235" name="l00235"></a><span class="lineno">  235</span>class UntypedOnCallSpecBase {</div>
<div class="line"><a id="l00236" name="l00236"></a><span class="lineno">  236</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00237" name="l00237"></a><span class="lineno">  237</span>  <span class="comment">// The arguments are the location of the ON_CALL() statement.</span></div>
<div class="line"><a id="l00238" name="l00238"></a><span class="lineno">  238</span>  UntypedOnCallSpecBase(<span class="keyword">const</span> <span class="keywordtype">char</span>* a_file, <span class="keywordtype">int</span> a_line)</div>
<div class="line"><a id="l00239" name="l00239"></a><span class="lineno">  239</span>      : file_(a_file), line_(a_line), last_clause_(kNone) {}</div>
<div class="line"><a id="l00240" name="l00240"></a><span class="lineno">  240</span> </div>
<div class="line"><a id="l00241" name="l00241"></a><span class="lineno">  241</span>  <span class="comment">// Where in the source file was the default action spec defined?</span></div>
<div class="line"><a id="l00242" name="l00242"></a><span class="lineno">  242</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* file()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> file_; }</div>
<div class="line"><a id="l00243" name="l00243"></a><span class="lineno">  243</span>  <span class="keywordtype">int</span> line()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> line_; }</div>
<div class="line"><a id="l00244" name="l00244"></a><span class="lineno">  244</span> </div>
<div class="line"><a id="l00245" name="l00245"></a><span class="lineno">  245</span> <span class="keyword">protected</span>:</div>
<div class="line"><a id="l00246" name="l00246"></a><span class="lineno">  246</span>  <span class="comment">// Gives each clause in the ON_CALL() statement a name.</span></div>
<div class="line"><a id="l00247" name="l00247"></a><span class="lineno">  247</span>  <span class="keyword">enum</span> Clause {</div>
<div class="line"><a id="l00248" name="l00248"></a><span class="lineno">  248</span>    <span class="comment">// Do not change the order of the enum members!  The run-time</span></div>
<div class="line"><a id="l00249" name="l00249"></a><span class="lineno">  249</span>    <span class="comment">// syntax checking relies on it.</span></div>
<div class="line"><a id="l00250" name="l00250"></a><span class="lineno">  250</span>    kNone,</div>
<div class="line"><a id="l00251" name="l00251"></a><span class="lineno">  251</span>    kWith,</div>
<div class="line"><a id="l00252" name="l00252"></a><span class="lineno">  252</span>    kWillByDefault</div>
<div class="line"><a id="l00253" name="l00253"></a><span class="lineno">  253</span>  };</div>
<div class="line"><a id="l00254" name="l00254"></a><span class="lineno">  254</span> </div>
<div class="line"><a id="l00255" name="l00255"></a><span class="lineno">  255</span>  <span class="comment">// Asserts that the ON_CALL() statement has a certain property.</span></div>
<div class="line"><a id="l00256" name="l00256"></a><span class="lineno">  256</span>  <span class="keywordtype">void</span> AssertSpecProperty(<span class="keywordtype">bool</span> property,</div>
<div class="line"><a id="l00257" name="l00257"></a><span class="lineno">  257</span>                          <span class="keyword">const</span> std::string&amp; failure_message)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00258" name="l00258"></a><span class="lineno">  258</span>    Assert(property, file_, line_, failure_message);</div>
<div class="line"><a id="l00259" name="l00259"></a><span class="lineno">  259</span>  }</div>
<div class="line"><a id="l00260" name="l00260"></a><span class="lineno">  260</span> </div>
<div class="line"><a id="l00261" name="l00261"></a><span class="lineno">  261</span>  <span class="comment">// Expects that the ON_CALL() statement has a certain property.</span></div>
<div class="line"><a id="l00262" name="l00262"></a><span class="lineno">  262</span>  <span class="keywordtype">void</span> ExpectSpecProperty(<span class="keywordtype">bool</span> property,</div>
<div class="line"><a id="l00263" name="l00263"></a><span class="lineno">  263</span>                          <span class="keyword">const</span> std::string&amp; failure_message)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00264" name="l00264"></a><span class="lineno">  264</span>    Expect(property, file_, line_, failure_message);</div>
<div class="line"><a id="l00265" name="l00265"></a><span class="lineno">  265</span>  }</div>
<div class="line"><a id="l00266" name="l00266"></a><span class="lineno">  266</span> </div>
<div class="line"><a id="l00267" name="l00267"></a><span class="lineno">  267</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* file_;</div>
<div class="line"><a id="l00268" name="l00268"></a><span class="lineno">  268</span>  <span class="keywordtype">int</span> line_;</div>
<div class="line"><a id="l00269" name="l00269"></a><span class="lineno">  269</span> </div>
<div class="line"><a id="l00270" name="l00270"></a><span class="lineno">  270</span>  <span class="comment">// The last clause in the ON_CALL() statement as seen so far.</span></div>
<div class="line"><a id="l00271" name="l00271"></a><span class="lineno">  271</span>  <span class="comment">// Initially kNone and changes as the statement is parsed.</span></div>
<div class="line"><a id="l00272" name="l00272"></a><span class="lineno">  272</span>  Clause last_clause_;</div>
<div class="line"><a id="l00273" name="l00273"></a><span class="lineno">  273</span>};  <span class="comment">// class UntypedOnCallSpecBase</span></div>
<div class="line"><a id="l00274" name="l00274"></a><span class="lineno">  274</span> </div>
<div class="line"><a id="l00275" name="l00275"></a><span class="lineno">  275</span><span class="comment">// This template class implements an ON_CALL spec.</span></div>
<div class="line"><a id="l00276" name="l00276"></a><span class="lineno">  276</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l00277" name="l00277"></a><span class="lineno">  277</span><span class="keyword">class </span>OnCallSpec : <span class="keyword">public</span> UntypedOnCallSpecBase {</div>
<div class="line"><a id="l00278" name="l00278"></a><span class="lineno">  278</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00279" name="l00279"></a><span class="lineno">  279</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> Function&lt;F&gt;::ArgumentTuple ArgumentTuple;</div>
<div class="line"><a id="l00280" name="l00280"></a><span class="lineno">  280</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> Function&lt;F&gt;::ArgumentMatcherTuple ArgumentMatcherTuple;</div>
<div class="line"><a id="l00281" name="l00281"></a><span class="lineno">  281</span> </div>
<div class="line"><a id="l00282" name="l00282"></a><span class="lineno">  282</span>  <span class="comment">// Constructs an OnCallSpec object from the information inside</span></div>
<div class="line"><a id="l00283" name="l00283"></a><span class="lineno">  283</span>  <span class="comment">// the parenthesis of an ON_CALL() statement.</span></div>
<div class="line"><a id="l00284" name="l00284"></a><span class="lineno">  284</span>  OnCallSpec(<span class="keyword">const</span> <span class="keywordtype">char</span>* a_file, <span class="keywordtype">int</span> a_line,</div>
<div class="line"><a id="l00285" name="l00285"></a><span class="lineno">  285</span>             <span class="keyword">const</span> ArgumentMatcherTuple&amp; matchers)</div>
<div class="line"><a id="l00286" name="l00286"></a><span class="lineno">  286</span>      : UntypedOnCallSpecBase(a_file, a_line),</div>
<div class="line"><a id="l00287" name="l00287"></a><span class="lineno">  287</span>        matchers_(matchers),</div>
<div class="line"><a id="l00288" name="l00288"></a><span class="lineno">  288</span>        <span class="comment">// By default, extra_matcher_ should match anything.  However,</span></div>
<div class="line"><a id="l00289" name="l00289"></a><span class="lineno">  289</span>        <span class="comment">// we cannot initialize it with _ as that causes ambiguity between</span></div>
<div class="line"><a id="l00290" name="l00290"></a><span class="lineno">  290</span>        <span class="comment">// Matcher&#39;s copy and move constructor for some argument types.</span></div>
<div class="line"><a id="l00291" name="l00291"></a><span class="lineno">  291</span>        extra_matcher_(A&lt;const ArgumentTuple&amp;&gt;()) {}</div>
<div class="line"><a id="l00292" name="l00292"></a><span class="lineno">  292</span> </div>
<div class="line"><a id="l00293" name="l00293"></a><span class="lineno">  293</span>  <span class="comment">// Implements the .With() clause.</span></div>
<div class="line"><a id="l00294" name="l00294"></a><span class="lineno">  294</span>  OnCallSpec&amp; With(<span class="keyword">const</span> Matcher&lt;const ArgumentTuple&amp;&gt;&amp; m) {</div>
<div class="line"><a id="l00295" name="l00295"></a><span class="lineno">  295</span>    <span class="comment">// Makes sure this is called at most once.</span></div>
<div class="line"><a id="l00296" name="l00296"></a><span class="lineno">  296</span>    ExpectSpecProperty(last_clause_ &lt; kWith,</div>
<div class="line"><a id="l00297" name="l00297"></a><span class="lineno">  297</span>                       <span class="stringliteral">&quot;.With() cannot appear &quot;</span></div>
<div class="line"><a id="l00298" name="l00298"></a><span class="lineno">  298</span>                       <span class="stringliteral">&quot;more than once in an ON_CALL().&quot;</span>);</div>
<div class="line"><a id="l00299" name="l00299"></a><span class="lineno">  299</span>    last_clause_ = kWith;</div>
<div class="line"><a id="l00300" name="l00300"></a><span class="lineno">  300</span> </div>
<div class="line"><a id="l00301" name="l00301"></a><span class="lineno">  301</span>    extra_matcher_ = m;</div>
<div class="line"><a id="l00302" name="l00302"></a><span class="lineno">  302</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l00303" name="l00303"></a><span class="lineno">  303</span>  }</div>
<div class="line"><a id="l00304" name="l00304"></a><span class="lineno">  304</span> </div>
<div class="line"><a id="l00305" name="l00305"></a><span class="lineno">  305</span>  <span class="comment">// Implements the .WillByDefault() clause.</span></div>
<div class="line"><a id="l00306" name="l00306"></a><span class="lineno">  306</span>  OnCallSpec&amp; WillByDefault(<span class="keyword">const</span> Action&lt;F&gt;&amp; action) {</div>
<div class="line"><a id="l00307" name="l00307"></a><span class="lineno">  307</span>    ExpectSpecProperty(last_clause_ &lt; kWillByDefault,</div>
<div class="line"><a id="l00308" name="l00308"></a><span class="lineno">  308</span>                       <span class="stringliteral">&quot;.WillByDefault() must appear &quot;</span></div>
<div class="line"><a id="l00309" name="l00309"></a><span class="lineno">  309</span>                       <span class="stringliteral">&quot;exactly once in an ON_CALL().&quot;</span>);</div>
<div class="line"><a id="l00310" name="l00310"></a><span class="lineno">  310</span>    last_clause_ = kWillByDefault;</div>
<div class="line"><a id="l00311" name="l00311"></a><span class="lineno">  311</span> </div>
<div class="line"><a id="l00312" name="l00312"></a><span class="lineno">  312</span>    ExpectSpecProperty(!action.IsDoDefault(),</div>
<div class="line"><a id="l00313" name="l00313"></a><span class="lineno">  313</span>                       <span class="stringliteral">&quot;DoDefault() cannot be used in ON_CALL().&quot;</span>);</div>
<div class="line"><a id="l00314" name="l00314"></a><span class="lineno">  314</span>    action_ = action;</div>
<div class="line"><a id="l00315" name="l00315"></a><span class="lineno">  315</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l00316" name="l00316"></a><span class="lineno">  316</span>  }</div>
<div class="line"><a id="l00317" name="l00317"></a><span class="lineno">  317</span> </div>
<div class="line"><a id="l00318" name="l00318"></a><span class="lineno">  318</span>  <span class="comment">// Returns true if and only if the given arguments match the matchers.</span></div>
<div class="line"><a id="l00319" name="l00319"></a><span class="lineno">  319</span>  <span class="keywordtype">bool</span> Matches(<span class="keyword">const</span> ArgumentTuple&amp; args)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00320" name="l00320"></a><span class="lineno">  320</span>    <span class="keywordflow">return</span> TupleMatches(matchers_, args) &amp;&amp; extra_matcher_.Matches(args);</div>
<div class="line"><a id="l00321" name="l00321"></a><span class="lineno">  321</span>  }</div>
<div class="line"><a id="l00322" name="l00322"></a><span class="lineno">  322</span> </div>
<div class="line"><a id="l00323" name="l00323"></a><span class="lineno">  323</span>  <span class="comment">// Returns the action specified by the user.</span></div>
<div class="line"><a id="l00324" name="l00324"></a><span class="lineno">  324</span>  <span class="keyword">const</span> Action&lt;F&gt;&amp; GetAction()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00325" name="l00325"></a><span class="lineno">  325</span>    AssertSpecProperty(last_clause_ == kWillByDefault,</div>
<div class="line"><a id="l00326" name="l00326"></a><span class="lineno">  326</span>                       <span class="stringliteral">&quot;.WillByDefault() must appear exactly &quot;</span></div>
<div class="line"><a id="l00327" name="l00327"></a><span class="lineno">  327</span>                       <span class="stringliteral">&quot;once in an ON_CALL().&quot;</span>);</div>
<div class="line"><a id="l00328" name="l00328"></a><span class="lineno">  328</span>    <span class="keywordflow">return</span> action_;</div>
<div class="line"><a id="l00329" name="l00329"></a><span class="lineno">  329</span>  }</div>
<div class="line"><a id="l00330" name="l00330"></a><span class="lineno">  330</span> </div>
<div class="line"><a id="l00331" name="l00331"></a><span class="lineno">  331</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00332" name="l00332"></a><span class="lineno">  332</span>  <span class="comment">// The information in statement</span></div>
<div class="line"><a id="l00333" name="l00333"></a><span class="lineno">  333</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00334" name="l00334"></a><span class="lineno">  334</span>  <span class="comment">//   ON_CALL(mock_object, Method(matchers))</span></div>
<div class="line"><a id="l00335" name="l00335"></a><span class="lineno">  335</span>  <span class="comment">//       .With(multi-argument-matcher)</span></div>
<div class="line"><a id="l00336" name="l00336"></a><span class="lineno">  336</span>  <span class="comment">//       .WillByDefault(action);</span></div>
<div class="line"><a id="l00337" name="l00337"></a><span class="lineno">  337</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00338" name="l00338"></a><span class="lineno">  338</span>  <span class="comment">// is recorded in the data members like this:</span></div>
<div class="line"><a id="l00339" name="l00339"></a><span class="lineno">  339</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00340" name="l00340"></a><span class="lineno">  340</span>  <span class="comment">//   source file that contains the statement =&gt; file_</span></div>
<div class="line"><a id="l00341" name="l00341"></a><span class="lineno">  341</span>  <span class="comment">//   line number of the statement            =&gt; line_</span></div>
<div class="line"><a id="l00342" name="l00342"></a><span class="lineno">  342</span>  <span class="comment">//   matchers                                =&gt; matchers_</span></div>
<div class="line"><a id="l00343" name="l00343"></a><span class="lineno">  343</span>  <span class="comment">//   multi-argument-matcher                  =&gt; extra_matcher_</span></div>
<div class="line"><a id="l00344" name="l00344"></a><span class="lineno">  344</span>  <span class="comment">//   action                                  =&gt; action_</span></div>
<div class="line"><a id="l00345" name="l00345"></a><span class="lineno">  345</span>  ArgumentMatcherTuple matchers_;</div>
<div class="line"><a id="l00346" name="l00346"></a><span class="lineno">  346</span>  Matcher&lt;const ArgumentTuple&amp;&gt; extra_matcher_;</div>
<div class="line"><a id="l00347" name="l00347"></a><span class="lineno">  347</span>  Action&lt;F&gt; action_;</div>
<div class="line"><a id="l00348" name="l00348"></a><span class="lineno">  348</span>};  <span class="comment">// class OnCallSpec</span></div>
<div class="line"><a id="l00349" name="l00349"></a><span class="lineno">  349</span> </div>
<div class="line"><a id="l00350" name="l00350"></a><span class="lineno">  350</span><span class="comment">// Possible reactions on uninteresting calls.</span></div>
<div class="line"><a id="l00351" name="l00351"></a><span class="lineno">  351</span><span class="keyword">enum</span> CallReaction {</div>
<div class="line"><a id="l00352" name="l00352"></a><span class="lineno">  352</span>  kAllow,</div>
<div class="line"><a id="l00353" name="l00353"></a><span class="lineno">  353</span>  kWarn,</div>
<div class="line"><a id="l00354" name="l00354"></a><span class="lineno">  354</span>  kFail,</div>
<div class="line"><a id="l00355" name="l00355"></a><span class="lineno">  355</span>};</div>
<div class="line"><a id="l00356" name="l00356"></a><span class="lineno">  356</span> </div>
<div class="line"><a id="l00357" name="l00357"></a><span class="lineno">  357</span>}  <span class="comment">// namespace internal</span></div>
<div class="line"><a id="l00358" name="l00358"></a><span class="lineno">  358</span> </div>
<div class="line"><a id="l00359" name="l00359"></a><span class="lineno">  359</span><span class="comment">// Utilities for manipulating mock objects.</span></div>
<div class="line"><a id="l00360" name="l00360"></a><span class="lineno">  360</span><span class="keyword">class </span>GTEST_API_ Mock {</div>
<div class="line"><a id="l00361" name="l00361"></a><span class="lineno">  361</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00362" name="l00362"></a><span class="lineno">  362</span>  <span class="comment">// The following public methods can be called concurrently.</span></div>
<div class="line"><a id="l00363" name="l00363"></a><span class="lineno">  363</span> </div>
<div class="line"><a id="l00364" name="l00364"></a><span class="lineno">  364</span>  <span class="comment">// Tells Google Mock to ignore mock_obj when checking for leaked</span></div>
<div class="line"><a id="l00365" name="l00365"></a><span class="lineno">  365</span>  <span class="comment">// mock objects.</span></div>
<div class="line"><a id="l00366" name="l00366"></a><span class="lineno">  366</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> AllowLeak(<span class="keyword">const</span> <span class="keywordtype">void</span>* mock_obj)</div>
<div class="line"><a id="l00367" name="l00367"></a><span class="lineno">  367</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00368" name="l00368"></a><span class="lineno">  368</span> </div>
<div class="line"><a id="l00369" name="l00369"></a><span class="lineno">  369</span>  <span class="comment">// Verifies and clears all expectations on the given mock object.</span></div>
<div class="line"><a id="l00370" name="l00370"></a><span class="lineno">  370</span>  <span class="comment">// If the expectations aren&#39;t satisfied, generates one or more</span></div>
<div class="line"><a id="l00371" name="l00371"></a><span class="lineno">  371</span>  <span class="comment">// Google Test non-fatal failures and returns false.</span></div>
<div class="line"><a id="l00372" name="l00372"></a><span class="lineno">  372</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> VerifyAndClearExpectations(<span class="keywordtype">void</span>* mock_obj)</div>
<div class="line"><a id="l00373" name="l00373"></a><span class="lineno">  373</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00374" name="l00374"></a><span class="lineno">  374</span> </div>
<div class="line"><a id="l00375" name="l00375"></a><span class="lineno">  375</span>  <span class="comment">// Verifies all expectations on the given mock object and clears its</span></div>
<div class="line"><a id="l00376" name="l00376"></a><span class="lineno">  376</span>  <span class="comment">// default actions and expectations.  Returns true if and only if the</span></div>
<div class="line"><a id="l00377" name="l00377"></a><span class="lineno">  377</span>  <span class="comment">// verification was successful.</span></div>
<div class="line"><a id="l00378" name="l00378"></a><span class="lineno">  378</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> VerifyAndClear(<span class="keywordtype">void</span>* mock_obj)</div>
<div class="line"><a id="l00379" name="l00379"></a><span class="lineno">  379</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00380" name="l00380"></a><span class="lineno">  380</span> </div>
<div class="line"><a id="l00381" name="l00381"></a><span class="lineno">  381</span>  <span class="comment">// Returns whether the mock was created as a naggy mock (default)</span></div>
<div class="line"><a id="l00382" name="l00382"></a><span class="lineno">  382</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> IsNaggy(<span class="keywordtype">void</span>* mock_obj)</div>
<div class="line"><a id="l00383" name="l00383"></a><span class="lineno">  383</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00384" name="l00384"></a><span class="lineno">  384</span>  <span class="comment">// Returns whether the mock was created as a nice mock</span></div>
<div class="line"><a id="l00385" name="l00385"></a><span class="lineno">  385</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> IsNice(<span class="keywordtype">void</span>* mock_obj)</div>
<div class="line"><a id="l00386" name="l00386"></a><span class="lineno">  386</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00387" name="l00387"></a><span class="lineno">  387</span>  <span class="comment">// Returns whether the mock was created as a strict mock</span></div>
<div class="line"><a id="l00388" name="l00388"></a><span class="lineno">  388</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> IsStrict(<span class="keywordtype">void</span>* mock_obj)</div>
<div class="line"><a id="l00389" name="l00389"></a><span class="lineno">  389</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00390" name="l00390"></a><span class="lineno">  390</span> </div>
<div class="line"><a id="l00391" name="l00391"></a><span class="lineno">  391</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00392" name="l00392"></a><span class="lineno">  392</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::UntypedFunctionMockerBase;</div>
<div class="line"><a id="l00393" name="l00393"></a><span class="lineno">  393</span> </div>
<div class="line"><a id="l00394" name="l00394"></a><span class="lineno">  394</span>  <span class="comment">// Needed for a function mocker to register itself (so that we know</span></div>
<div class="line"><a id="l00395" name="l00395"></a><span class="lineno">  395</span>  <span class="comment">// how to clear a mock object).</span></div>
<div class="line"><a id="l00396" name="l00396"></a><span class="lineno">  396</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l00397" name="l00397"></a><span class="lineno">  397</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::FunctionMocker;</div>
<div class="line"><a id="l00398" name="l00398"></a><span class="lineno">  398</span> </div>
<div class="line"><a id="l00399" name="l00399"></a><span class="lineno">  399</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> MockClass&gt;</div>
<div class="line"><a id="l00400" name="l00400"></a><span class="lineno">  400</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::NiceMockImpl;</div>
<div class="line"><a id="l00401" name="l00401"></a><span class="lineno">  401</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> MockClass&gt;</div>
<div class="line"><a id="l00402" name="l00402"></a><span class="lineno">  402</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::NaggyMockImpl;</div>
<div class="line"><a id="l00403" name="l00403"></a><span class="lineno">  403</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> MockClass&gt;</div>
<div class="line"><a id="l00404" name="l00404"></a><span class="lineno">  404</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::StrictMockImpl;</div>
<div class="line"><a id="l00405" name="l00405"></a><span class="lineno">  405</span> </div>
<div class="line"><a id="l00406" name="l00406"></a><span class="lineno">  406</span>  <span class="comment">// Tells Google Mock to allow uninteresting calls on the given mock</span></div>
<div class="line"><a id="l00407" name="l00407"></a><span class="lineno">  407</span>  <span class="comment">// object.</span></div>
<div class="line"><a id="l00408" name="l00408"></a><span class="lineno">  408</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> AllowUninterestingCalls(uintptr_t mock_obj)</div>
<div class="line"><a id="l00409" name="l00409"></a><span class="lineno">  409</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00410" name="l00410"></a><span class="lineno">  410</span> </div>
<div class="line"><a id="l00411" name="l00411"></a><span class="lineno">  411</span>  <span class="comment">// Tells Google Mock to warn the user about uninteresting calls on</span></div>
<div class="line"><a id="l00412" name="l00412"></a><span class="lineno">  412</span>  <span class="comment">// the given mock object.</span></div>
<div class="line"><a id="l00413" name="l00413"></a><span class="lineno">  413</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> WarnUninterestingCalls(uintptr_t mock_obj)</div>
<div class="line"><a id="l00414" name="l00414"></a><span class="lineno">  414</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00415" name="l00415"></a><span class="lineno">  415</span> </div>
<div class="line"><a id="l00416" name="l00416"></a><span class="lineno">  416</span>  <span class="comment">// Tells Google Mock to fail uninteresting calls on the given mock</span></div>
<div class="line"><a id="l00417" name="l00417"></a><span class="lineno">  417</span>  <span class="comment">// object.</span></div>
<div class="line"><a id="l00418" name="l00418"></a><span class="lineno">  418</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> FailUninterestingCalls(uintptr_t mock_obj)</div>
<div class="line"><a id="l00419" name="l00419"></a><span class="lineno">  419</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00420" name="l00420"></a><span class="lineno">  420</span> </div>
<div class="line"><a id="l00421" name="l00421"></a><span class="lineno">  421</span>  <span class="comment">// Tells Google Mock the given mock object is being destroyed and</span></div>
<div class="line"><a id="l00422" name="l00422"></a><span class="lineno">  422</span>  <span class="comment">// its entry in the call-reaction table should be removed.</span></div>
<div class="line"><a id="l00423" name="l00423"></a><span class="lineno">  423</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> UnregisterCallReaction(uintptr_t mock_obj)</div>
<div class="line"><a id="l00424" name="l00424"></a><span class="lineno">  424</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00425" name="l00425"></a><span class="lineno">  425</span> </div>
<div class="line"><a id="l00426" name="l00426"></a><span class="lineno">  426</span>  <span class="comment">// Returns the reaction Google Mock will have on uninteresting calls</span></div>
<div class="line"><a id="l00427" name="l00427"></a><span class="lineno">  427</span>  <span class="comment">// made on the given mock object.</span></div>
<div class="line"><a id="l00428" name="l00428"></a><span class="lineno">  428</span>  <span class="keyword">static</span> internal::CallReaction GetReactionOnUninterestingCalls(</div>
<div class="line"><a id="l00429" name="l00429"></a><span class="lineno">  429</span>      <span class="keyword">const</span> <span class="keywordtype">void</span>* mock_obj) GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00430" name="l00430"></a><span class="lineno">  430</span> </div>
<div class="line"><a id="l00431" name="l00431"></a><span class="lineno">  431</span>  <span class="comment">// Verifies that all expectations on the given mock object have been</span></div>
<div class="line"><a id="l00432" name="l00432"></a><span class="lineno">  432</span>  <span class="comment">// satisfied.  Reports one or more Google Test non-fatal failures</span></div>
<div class="line"><a id="l00433" name="l00433"></a><span class="lineno">  433</span>  <span class="comment">// and returns false if not.</span></div>
<div class="line"><a id="l00434" name="l00434"></a><span class="lineno">  434</span>  <span class="keyword">static</span> <span class="keywordtype">bool</span> VerifyAndClearExpectationsLocked(<span class="keywordtype">void</span>* mock_obj)</div>
<div class="line"><a id="l00435" name="l00435"></a><span class="lineno">  435</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00436" name="l00436"></a><span class="lineno">  436</span> </div>
<div class="line"><a id="l00437" name="l00437"></a><span class="lineno">  437</span>  <span class="comment">// Clears all ON_CALL()s set on the given mock object.</span></div>
<div class="line"><a id="l00438" name="l00438"></a><span class="lineno">  438</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> ClearDefaultActionsLocked(<span class="keywordtype">void</span>* mock_obj)</div>
<div class="line"><a id="l00439" name="l00439"></a><span class="lineno">  439</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00440" name="l00440"></a><span class="lineno">  440</span> </div>
<div class="line"><a id="l00441" name="l00441"></a><span class="lineno">  441</span>  <span class="comment">// Registers a mock object and a mock method it owns.</span></div>
<div class="line"><a id="l00442" name="l00442"></a><span class="lineno">  442</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> Register(<span class="keyword">const</span> <span class="keywordtype">void</span>* mock_obj,</div>
<div class="line"><a id="l00443" name="l00443"></a><span class="lineno">  443</span>                       internal::UntypedFunctionMockerBase* mocker)</div>
<div class="line"><a id="l00444" name="l00444"></a><span class="lineno">  444</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00445" name="l00445"></a><span class="lineno">  445</span> </div>
<div class="line"><a id="l00446" name="l00446"></a><span class="lineno">  446</span>  <span class="comment">// Tells Google Mock where in the source code mock_obj is used in an</span></div>
<div class="line"><a id="l00447" name="l00447"></a><span class="lineno">  447</span>  <span class="comment">// ON_CALL or EXPECT_CALL.  In case mock_obj is leaked, this</span></div>
<div class="line"><a id="l00448" name="l00448"></a><span class="lineno">  448</span>  <span class="comment">// information helps the user identify which object it is.</span></div>
<div class="line"><a id="l00449" name="l00449"></a><span class="lineno">  449</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> RegisterUseByOnCallOrExpectCall(<span class="keyword">const</span> <span class="keywordtype">void</span>* mock_obj,</div>
<div class="line"><a id="l00450" name="l00450"></a><span class="lineno">  450</span>                                              <span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line)</div>
<div class="line"><a id="l00451" name="l00451"></a><span class="lineno">  451</span>      GTEST_LOCK_EXCLUDED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00452" name="l00452"></a><span class="lineno">  452</span> </div>
<div class="line"><a id="l00453" name="l00453"></a><span class="lineno">  453</span>  <span class="comment">// Unregisters a mock method; removes the owning mock object from</span></div>
<div class="line"><a id="l00454" name="l00454"></a><span class="lineno">  454</span>  <span class="comment">// the registry when the last mock method associated with it has</span></div>
<div class="line"><a id="l00455" name="l00455"></a><span class="lineno">  455</span>  <span class="comment">// been unregistered.  This is called only in the destructor of</span></div>
<div class="line"><a id="l00456" name="l00456"></a><span class="lineno">  456</span>  <span class="comment">// FunctionMocker.</span></div>
<div class="line"><a id="l00457" name="l00457"></a><span class="lineno">  457</span>  <span class="keyword">static</span> <span class="keywordtype">void</span> UnregisterLocked(internal::UntypedFunctionMockerBase* mocker)</div>
<div class="line"><a id="l00458" name="l00458"></a><span class="lineno">  458</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(internal::g_gmock_mutex);</div>
<div class="line"><a id="l00459" name="l00459"></a><span class="lineno">  459</span>};  <span class="comment">// class Mock</span></div>
<div class="line"><a id="l00460" name="l00460"></a><span class="lineno">  460</span> </div>
<div class="line"><a id="l00461" name="l00461"></a><span class="lineno">  461</span><span class="comment">// An abstract handle of an expectation.  Useful in the .After()</span></div>
<div class="line"><a id="l00462" name="l00462"></a><span class="lineno">  462</span><span class="comment">// clause of EXPECT_CALL() for setting the (partial) order of</span></div>
<div class="line"><a id="l00463" name="l00463"></a><span class="lineno">  463</span><span class="comment">// expectations.  The syntax:</span></div>
<div class="line"><a id="l00464" name="l00464"></a><span class="lineno">  464</span><span class="comment">//</span></div>
<div class="line"><a id="l00465" name="l00465"></a><span class="lineno">  465</span><span class="comment">//   Expectation e1 = EXPECT_CALL(...)...;</span></div>
<div class="line"><a id="l00466" name="l00466"></a><span class="lineno">  466</span><span class="comment">//   EXPECT_CALL(...).After(e1)...;</span></div>
<div class="line"><a id="l00467" name="l00467"></a><span class="lineno">  467</span><span class="comment">//</span></div>
<div class="line"><a id="l00468" name="l00468"></a><span class="lineno">  468</span><span class="comment">// sets two expectations where the latter can only be matched after</span></div>
<div class="line"><a id="l00469" name="l00469"></a><span class="lineno">  469</span><span class="comment">// the former has been satisfied.</span></div>
<div class="line"><a id="l00470" name="l00470"></a><span class="lineno">  470</span><span class="comment">//</span></div>
<div class="line"><a id="l00471" name="l00471"></a><span class="lineno">  471</span><span class="comment">// Notes:</span></div>
<div class="line"><a id="l00472" name="l00472"></a><span class="lineno">  472</span><span class="comment">//   - This class is copyable and has value semantics.</span></div>
<div class="line"><a id="l00473" name="l00473"></a><span class="lineno">  473</span><span class="comment">//   - Constness is shallow: a const Expectation object itself cannot</span></div>
<div class="line"><a id="l00474" name="l00474"></a><span class="lineno">  474</span><span class="comment">//     be modified, but the mutable methods of the ExpectationBase</span></div>
<div class="line"><a id="l00475" name="l00475"></a><span class="lineno">  475</span><span class="comment">//     object it references can be called via expectation_base().</span></div>
<div class="line"><a id="l00476" name="l00476"></a><span class="lineno">  476</span> </div>
<div class="line"><a id="l00477" name="l00477"></a><span class="lineno">  477</span><span class="keyword">class </span>GTEST_API_ Expectation {</div>
<div class="line"><a id="l00478" name="l00478"></a><span class="lineno">  478</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00479" name="l00479"></a><span class="lineno">  479</span>  <span class="comment">// Constructs a null object that doesn&#39;t reference any expectation.</span></div>
<div class="line"><a id="l00480" name="l00480"></a><span class="lineno">  480</span>  Expectation();</div>
<div class="line"><a id="l00481" name="l00481"></a><span class="lineno">  481</span>  Expectation(Expectation&amp;&amp;) = <span class="keywordflow">default</span>;</div>
<div class="line"><a id="l00482" name="l00482"></a><span class="lineno">  482</span>  Expectation(<span class="keyword">const</span> Expectation&amp;) = <span class="keywordflow">default</span>;</div>
<div class="line"><a id="l00483" name="l00483"></a><span class="lineno">  483</span>  Expectation&amp; operator=(Expectation&amp;&amp;) = <span class="keywordflow">default</span>;</div>
<div class="line"><a id="l00484" name="l00484"></a><span class="lineno">  484</span>  Expectation&amp; operator=(<span class="keyword">const</span> Expectation&amp;) = <span class="keywordflow">default</span>;</div>
<div class="line"><a id="l00485" name="l00485"></a><span class="lineno">  485</span>  ~Expectation();</div>
<div class="line"><a id="l00486" name="l00486"></a><span class="lineno">  486</span> </div>
<div class="line"><a id="l00487" name="l00487"></a><span class="lineno">  487</span>  <span class="comment">// This single-argument ctor must not be explicit, in order to support the</span></div>
<div class="line"><a id="l00488" name="l00488"></a><span class="lineno">  488</span>  <span class="comment">//   Expectation e = EXPECT_CALL(...);</span></div>
<div class="line"><a id="l00489" name="l00489"></a><span class="lineno">  489</span>  <span class="comment">// syntax.</span></div>
<div class="line"><a id="l00490" name="l00490"></a><span class="lineno">  490</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00491" name="l00491"></a><span class="lineno">  491</span>  <span class="comment">// A TypedExpectation object stores its pre-requisites as</span></div>
<div class="line"><a id="l00492" name="l00492"></a><span class="lineno">  492</span>  <span class="comment">// Expectation objects, and needs to call the non-const Retire()</span></div>
<div class="line"><a id="l00493" name="l00493"></a><span class="lineno">  493</span>  <span class="comment">// method on the ExpectationBase objects they reference.  Therefore</span></div>
<div class="line"><a id="l00494" name="l00494"></a><span class="lineno">  494</span>  <span class="comment">// Expectation must receive a *non-const* reference to the</span></div>
<div class="line"><a id="l00495" name="l00495"></a><span class="lineno">  495</span>  <span class="comment">// ExpectationBase object.</span></div>
<div class="line"><a id="l00496" name="l00496"></a><span class="lineno">  496</span>  Expectation(internal::ExpectationBase&amp; exp);  <span class="comment">// NOLINT</span></div>
<div class="line"><a id="l00497" name="l00497"></a><span class="lineno">  497</span> </div>
<div class="line"><a id="l00498" name="l00498"></a><span class="lineno">  498</span>  <span class="comment">// The compiler-generated copy ctor and operator= work exactly as</span></div>
<div class="line"><a id="l00499" name="l00499"></a><span class="lineno">  499</span>  <span class="comment">// intended, so we don&#39;t need to define our own.</span></div>
<div class="line"><a id="l00500" name="l00500"></a><span class="lineno">  500</span> </div>
<div class="line"><a id="l00501" name="l00501"></a><span class="lineno">  501</span>  <span class="comment">// Returns true if and only if rhs references the same expectation as this</span></div>
<div class="line"><a id="l00502" name="l00502"></a><span class="lineno">  502</span>  <span class="comment">// object does.</span></div>
<div class="line"><a id="l00503" name="l00503"></a><span class="lineno">  503</span>  <span class="keywordtype">bool</span> operator==(<span class="keyword">const</span> Expectation&amp; rhs)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00504" name="l00504"></a><span class="lineno">  504</span>    <span class="keywordflow">return</span> expectation_base_ == rhs.expectation_base_;</div>
<div class="line"><a id="l00505" name="l00505"></a><span class="lineno">  505</span>  }</div>
<div class="line"><a id="l00506" name="l00506"></a><span class="lineno">  506</span> </div>
<div class="line"><a id="l00507" name="l00507"></a><span class="lineno">  507</span>  <span class="keywordtype">bool</span> operator!=(<span class="keyword">const</span> Expectation&amp; rhs)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> !(*<span class="keyword">this</span> == rhs); }</div>
<div class="line"><a id="l00508" name="l00508"></a><span class="lineno">  508</span> </div>
<div class="line"><a id="l00509" name="l00509"></a><span class="lineno">  509</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00510" name="l00510"></a><span class="lineno">  510</span>  <span class="keyword">friend</span> <span class="keyword">class </span>ExpectationSet;</div>
<div class="line"><a id="l00511" name="l00511"></a><span class="lineno">  511</span>  <span class="keyword">friend</span> <span class="keyword">class </span>Sequence;</div>
<div class="line"><a id="l00512" name="l00512"></a><span class="lineno">  512</span>  <span class="keyword">friend</span> class ::testing::internal::ExpectationBase;</div>
<div class="line"><a id="l00513" name="l00513"></a><span class="lineno">  513</span>  <span class="keyword">friend</span> class ::testing::internal::UntypedFunctionMockerBase;</div>
<div class="line"><a id="l00514" name="l00514"></a><span class="lineno">  514</span> </div>
<div class="line"><a id="l00515" name="l00515"></a><span class="lineno">  515</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l00516" name="l00516"></a><span class="lineno">  516</span>  <span class="keyword">friend</span> class ::testing::internal::FunctionMocker;</div>
<div class="line"><a id="l00517" name="l00517"></a><span class="lineno">  517</span> </div>
<div class="line"><a id="l00518" name="l00518"></a><span class="lineno">  518</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l00519" name="l00519"></a><span class="lineno">  519</span>  <span class="keyword">friend</span> class ::testing::internal::TypedExpectation;</div>
<div class="line"><a id="l00520" name="l00520"></a><span class="lineno">  520</span> </div>
<div class="line"><a id="l00521" name="l00521"></a><span class="lineno">  521</span>  <span class="comment">// This comparator is needed for putting Expectation objects into a set.</span></div>
<div class="line"><a id="l00522" name="l00522"></a><span class="lineno">  522</span>  <span class="keyword">class </span>Less {</div>
<div class="line"><a id="l00523" name="l00523"></a><span class="lineno">  523</span>   <span class="keyword">public</span>:</div>
<div class="line"><a id="l00524" name="l00524"></a><span class="lineno">  524</span>    <span class="keywordtype">bool</span> operator()(<span class="keyword">const</span> Expectation&amp; lhs, <span class="keyword">const</span> Expectation&amp; rhs)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00525" name="l00525"></a><span class="lineno">  525</span>      <span class="keywordflow">return</span> lhs.expectation_base_.get() &lt; rhs.expectation_base_.get();</div>
<div class="line"><a id="l00526" name="l00526"></a><span class="lineno">  526</span>    }</div>
<div class="line"><a id="l00527" name="l00527"></a><span class="lineno">  527</span>  };</div>
<div class="line"><a id="l00528" name="l00528"></a><span class="lineno">  528</span> </div>
<div class="line"><a id="l00529" name="l00529"></a><span class="lineno">  529</span>  typedef ::std::set&lt;Expectation, Less&gt; Set;</div>
<div class="line"><a id="l00530" name="l00530"></a><span class="lineno">  530</span> </div>
<div class="line"><a id="l00531" name="l00531"></a><span class="lineno">  531</span>  Expectation(</div>
<div class="line"><a id="l00532" name="l00532"></a><span class="lineno">  532</span>      <span class="keyword">const</span> std::shared_ptr&lt;internal::ExpectationBase&gt;&amp; expectation_base);</div>
<div class="line"><a id="l00533" name="l00533"></a><span class="lineno">  533</span> </div>
<div class="line"><a id="l00534" name="l00534"></a><span class="lineno">  534</span>  <span class="comment">// Returns the expectation this object references.</span></div>
<div class="line"><a id="l00535" name="l00535"></a><span class="lineno">  535</span>  <span class="keyword">const</span> std::shared_ptr&lt;internal::ExpectationBase&gt;&amp; expectation_base()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00536" name="l00536"></a><span class="lineno">  536</span>    <span class="keywordflow">return</span> expectation_base_;</div>
<div class="line"><a id="l00537" name="l00537"></a><span class="lineno">  537</span>  }</div>
<div class="line"><a id="l00538" name="l00538"></a><span class="lineno">  538</span> </div>
<div class="line"><a id="l00539" name="l00539"></a><span class="lineno">  539</span>  <span class="comment">// A shared_ptr that co-owns the expectation this handle references.</span></div>
<div class="line"><a id="l00540" name="l00540"></a><span class="lineno">  540</span>  std::shared_ptr&lt;internal::ExpectationBase&gt; expectation_base_;</div>
<div class="line"><a id="l00541" name="l00541"></a><span class="lineno">  541</span>};</div>
<div class="line"><a id="l00542" name="l00542"></a><span class="lineno">  542</span> </div>
<div class="line"><a id="l00543" name="l00543"></a><span class="lineno">  543</span><span class="comment">// A set of expectation handles.  Useful in the .After() clause of</span></div>
<div class="line"><a id="l00544" name="l00544"></a><span class="lineno">  544</span><span class="comment">// EXPECT_CALL() for setting the (partial) order of expectations.  The</span></div>
<div class="line"><a id="l00545" name="l00545"></a><span class="lineno">  545</span><span class="comment">// syntax:</span></div>
<div class="line"><a id="l00546" name="l00546"></a><span class="lineno">  546</span><span class="comment">//</span></div>
<div class="line"><a id="l00547" name="l00547"></a><span class="lineno">  547</span><span class="comment">//   ExpectationSet es;</span></div>
<div class="line"><a id="l00548" name="l00548"></a><span class="lineno">  548</span><span class="comment">//   es += EXPECT_CALL(...)...;</span></div>
<div class="line"><a id="l00549" name="l00549"></a><span class="lineno">  549</span><span class="comment">//   es += EXPECT_CALL(...)...;</span></div>
<div class="line"><a id="l00550" name="l00550"></a><span class="lineno">  550</span><span class="comment">//   EXPECT_CALL(...).After(es)...;</span></div>
<div class="line"><a id="l00551" name="l00551"></a><span class="lineno">  551</span><span class="comment">//</span></div>
<div class="line"><a id="l00552" name="l00552"></a><span class="lineno">  552</span><span class="comment">// sets three expectations where the last one can only be matched</span></div>
<div class="line"><a id="l00553" name="l00553"></a><span class="lineno">  553</span><span class="comment">// after the first two have both been satisfied.</span></div>
<div class="line"><a id="l00554" name="l00554"></a><span class="lineno">  554</span><span class="comment">//</span></div>
<div class="line"><a id="l00555" name="l00555"></a><span class="lineno">  555</span><span class="comment">// This class is copyable and has value semantics.</span></div>
<div class="line"><a id="l00556" name="l00556"></a><span class="lineno">  556</span><span class="keyword">class </span>ExpectationSet {</div>
<div class="line"><a id="l00557" name="l00557"></a><span class="lineno">  557</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00558" name="l00558"></a><span class="lineno">  558</span>  <span class="comment">// A bidirectional iterator that can read a const element in the set.</span></div>
<div class="line"><a id="l00559" name="l00559"></a><span class="lineno">  559</span>  <span class="keyword">typedef</span> Expectation::Set::const_iterator const_iterator;</div>
<div class="line"><a id="l00560" name="l00560"></a><span class="lineno">  560</span> </div>
<div class="line"><a id="l00561" name="l00561"></a><span class="lineno">  561</span>  <span class="comment">// An object stored in the set.  This is an alias of Expectation.</span></div>
<div class="line"><a id="l00562" name="l00562"></a><span class="lineno">  562</span>  <span class="keyword">typedef</span> Expectation::Set::value_type value_type;</div>
<div class="line"><a id="l00563" name="l00563"></a><span class="lineno">  563</span> </div>
<div class="line"><a id="l00564" name="l00564"></a><span class="lineno">  564</span>  <span class="comment">// Constructs an empty set.</span></div>
<div class="line"><a id="l00565" name="l00565"></a><span class="lineno">  565</span>  ExpectationSet() {}</div>
<div class="line"><a id="l00566" name="l00566"></a><span class="lineno">  566</span> </div>
<div class="line"><a id="l00567" name="l00567"></a><span class="lineno">  567</span>  <span class="comment">// This single-argument ctor must not be explicit, in order to support the</span></div>
<div class="line"><a id="l00568" name="l00568"></a><span class="lineno">  568</span>  <span class="comment">//   ExpectationSet es = EXPECT_CALL(...);</span></div>
<div class="line"><a id="l00569" name="l00569"></a><span class="lineno">  569</span>  <span class="comment">// syntax.</span></div>
<div class="line"><a id="l00570" name="l00570"></a><span class="lineno">  570</span>  ExpectationSet(internal::ExpectationBase&amp; exp) {  <span class="comment">// NOLINT</span></div>
<div class="line"><a id="l00571" name="l00571"></a><span class="lineno">  571</span>    *<span class="keyword">this</span> += Expectation(exp);</div>
<div class="line"><a id="l00572" name="l00572"></a><span class="lineno">  572</span>  }</div>
<div class="line"><a id="l00573" name="l00573"></a><span class="lineno">  573</span> </div>
<div class="line"><a id="l00574" name="l00574"></a><span class="lineno">  574</span>  <span class="comment">// This single-argument ctor implements implicit conversion from</span></div>
<div class="line"><a id="l00575" name="l00575"></a><span class="lineno">  575</span>  <span class="comment">// Expectation and thus must not be explicit.  This allows either an</span></div>
<div class="line"><a id="l00576" name="l00576"></a><span class="lineno">  576</span>  <span class="comment">// Expectation or an ExpectationSet to be used in .After().</span></div>
<div class="line"><a id="l00577" name="l00577"></a><span class="lineno">  577</span>  ExpectationSet(<span class="keyword">const</span> Expectation&amp; e) {  <span class="comment">// NOLINT</span></div>
<div class="line"><a id="l00578" name="l00578"></a><span class="lineno">  578</span>    *<span class="keyword">this</span> += e;</div>
<div class="line"><a id="l00579" name="l00579"></a><span class="lineno">  579</span>  }</div>
<div class="line"><a id="l00580" name="l00580"></a><span class="lineno">  580</span> </div>
<div class="line"><a id="l00581" name="l00581"></a><span class="lineno">  581</span>  <span class="comment">// The compiler-generator ctor and operator= works exactly as</span></div>
<div class="line"><a id="l00582" name="l00582"></a><span class="lineno">  582</span>  <span class="comment">// intended, so we don&#39;t need to define our own.</span></div>
<div class="line"><a id="l00583" name="l00583"></a><span class="lineno">  583</span> </div>
<div class="line"><a id="l00584" name="l00584"></a><span class="lineno">  584</span>  <span class="comment">// Returns true if and only if rhs contains the same set of Expectation</span></div>
<div class="line"><a id="l00585" name="l00585"></a><span class="lineno">  585</span>  <span class="comment">// objects as this does.</span></div>
<div class="line"><a id="l00586" name="l00586"></a><span class="lineno">  586</span>  <span class="keywordtype">bool</span> operator==(<span class="keyword">const</span> ExpectationSet&amp; rhs)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00587" name="l00587"></a><span class="lineno">  587</span>    <span class="keywordflow">return</span> expectations_ == rhs.expectations_;</div>
<div class="line"><a id="l00588" name="l00588"></a><span class="lineno">  588</span>  }</div>
<div class="line"><a id="l00589" name="l00589"></a><span class="lineno">  589</span> </div>
<div class="line"><a id="l00590" name="l00590"></a><span class="lineno">  590</span>  <span class="keywordtype">bool</span> operator!=(<span class="keyword">const</span> ExpectationSet&amp; rhs)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> !(*<span class="keyword">this</span> == rhs); }</div>
<div class="line"><a id="l00591" name="l00591"></a><span class="lineno">  591</span> </div>
<div class="line"><a id="l00592" name="l00592"></a><span class="lineno">  592</span>  <span class="comment">// Implements the syntax</span></div>
<div class="line"><a id="l00593" name="l00593"></a><span class="lineno">  593</span>  <span class="comment">//   expectation_set += EXPECT_CALL(...);</span></div>
<div class="line"><a id="l00594" name="l00594"></a><span class="lineno">  594</span>  ExpectationSet&amp; operator+=(<span class="keyword">const</span> Expectation&amp; e) {</div>
<div class="line"><a id="l00595" name="l00595"></a><span class="lineno">  595</span>    expectations_.insert(e);</div>
<div class="line"><a id="l00596" name="l00596"></a><span class="lineno">  596</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l00597" name="l00597"></a><span class="lineno">  597</span>  }</div>
<div class="line"><a id="l00598" name="l00598"></a><span class="lineno">  598</span> </div>
<div class="line"><a id="l00599" name="l00599"></a><span class="lineno">  599</span>  <span class="keywordtype">int</span> size()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> <span class="keyword">static_cast&lt;</span><span class="keywordtype">int</span><span class="keyword">&gt;</span>(expectations_.size()); }</div>
<div class="line"><a id="l00600" name="l00600"></a><span class="lineno">  600</span> </div>
<div class="line"><a id="l00601" name="l00601"></a><span class="lineno">  601</span>  const_iterator begin()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> expectations_.begin(); }</div>
<div class="line"><a id="l00602" name="l00602"></a><span class="lineno">  602</span>  const_iterator end()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> expectations_.end(); }</div>
<div class="line"><a id="l00603" name="l00603"></a><span class="lineno">  603</span> </div>
<div class="line"><a id="l00604" name="l00604"></a><span class="lineno">  604</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00605" name="l00605"></a><span class="lineno">  605</span>  Expectation::Set expectations_;</div>
<div class="line"><a id="l00606" name="l00606"></a><span class="lineno">  606</span>};</div>
<div class="line"><a id="l00607" name="l00607"></a><span class="lineno">  607</span> </div>
<div class="line"><a id="l00608" name="l00608"></a><span class="lineno">  608</span><span class="comment">// Sequence objects are used by a user to specify the relative order</span></div>
<div class="line"><a id="l00609" name="l00609"></a><span class="lineno">  609</span><span class="comment">// in which the expectations should match.  They are copyable (we rely</span></div>
<div class="line"><a id="l00610" name="l00610"></a><span class="lineno">  610</span><span class="comment">// on the compiler-defined copy constructor and assignment operator).</span></div>
<div class="line"><a id="l00611" name="l00611"></a><span class="lineno">  611</span><span class="keyword">class </span>GTEST_API_ Sequence {</div>
<div class="line"><a id="l00612" name="l00612"></a><span class="lineno">  612</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00613" name="l00613"></a><span class="lineno">  613</span>  <span class="comment">// Constructs an empty sequence.</span></div>
<div class="line"><a id="l00614" name="l00614"></a><span class="lineno">  614</span>  Sequence() : last_expectation_(new Expectation) {}</div>
<div class="line"><a id="l00615" name="l00615"></a><span class="lineno">  615</span> </div>
<div class="line"><a id="l00616" name="l00616"></a><span class="lineno">  616</span>  <span class="comment">// Adds an expectation to this sequence.  The caller must ensure</span></div>
<div class="line"><a id="l00617" name="l00617"></a><span class="lineno">  617</span>  <span class="comment">// that no other thread is accessing this Sequence object.</span></div>
<div class="line"><a id="l00618" name="l00618"></a><span class="lineno">  618</span>  <span class="keywordtype">void</span> AddExpectation(<span class="keyword">const</span> Expectation&amp; expectation) <span class="keyword">const</span>;</div>
<div class="line"><a id="l00619" name="l00619"></a><span class="lineno">  619</span> </div>
<div class="line"><a id="l00620" name="l00620"></a><span class="lineno">  620</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00621" name="l00621"></a><span class="lineno">  621</span>  <span class="comment">// The last expectation in this sequence.</span></div>
<div class="line"><a id="l00622" name="l00622"></a><span class="lineno">  622</span>  std::shared_ptr&lt;Expectation&gt; last_expectation_;</div>
<div class="line"><a id="l00623" name="l00623"></a><span class="lineno">  623</span>};  <span class="comment">// class Sequence</span></div>
<div class="line"><a id="l00624" name="l00624"></a><span class="lineno">  624</span> </div>
<div class="line"><a id="l00625" name="l00625"></a><span class="lineno">  625</span><span class="comment">// An object of this type causes all EXPECT_CALL() statements</span></div>
<div class="line"><a id="l00626" name="l00626"></a><span class="lineno">  626</span><span class="comment">// encountered in its scope to be put in an anonymous sequence.  The</span></div>
<div class="line"><a id="l00627" name="l00627"></a><span class="lineno">  627</span><span class="comment">// work is done in the constructor and destructor.  You should only</span></div>
<div class="line"><a id="l00628" name="l00628"></a><span class="lineno">  628</span><span class="comment">// create an InSequence object on the stack.</span></div>
<div class="line"><a id="l00629" name="l00629"></a><span class="lineno">  629</span><span class="comment">//</span></div>
<div class="line"><a id="l00630" name="l00630"></a><span class="lineno">  630</span><span class="comment">// The sole purpose for this class is to support easy definition of</span></div>
<div class="line"><a id="l00631" name="l00631"></a><span class="lineno">  631</span><span class="comment">// sequential expectations, e.g.</span></div>
<div class="line"><a id="l00632" name="l00632"></a><span class="lineno">  632</span><span class="comment">//</span></div>
<div class="line"><a id="l00633" name="l00633"></a><span class="lineno">  633</span><span class="comment">//   {</span></div>
<div class="line"><a id="l00634" name="l00634"></a><span class="lineno">  634</span><span class="comment">//     InSequence dummy;  // The name of the object doesn&#39;t matter.</span></div>
<div class="line"><a id="l00635" name="l00635"></a><span class="lineno">  635</span><span class="comment">//</span></div>
<div class="line"><a id="l00636" name="l00636"></a><span class="lineno">  636</span><span class="comment">//     // The following expectations must match in the order they appear.</span></div>
<div class="line"><a id="l00637" name="l00637"></a><span class="lineno">  637</span><span class="comment">//     EXPECT_CALL(a, Bar())...;</span></div>
<div class="line"><a id="l00638" name="l00638"></a><span class="lineno">  638</span><span class="comment">//     EXPECT_CALL(a, Baz())...;</span></div>
<div class="line"><a id="l00639" name="l00639"></a><span class="lineno">  639</span><span class="comment">//     ...</span></div>
<div class="line"><a id="l00640" name="l00640"></a><span class="lineno">  640</span><span class="comment">//     EXPECT_CALL(b, Xyz())...;</span></div>
<div class="line"><a id="l00641" name="l00641"></a><span class="lineno">  641</span><span class="comment">//   }</span></div>
<div class="line"><a id="l00642" name="l00642"></a><span class="lineno">  642</span><span class="comment">//</span></div>
<div class="line"><a id="l00643" name="l00643"></a><span class="lineno">  643</span><span class="comment">// You can create InSequence objects in multiple threads, as long as</span></div>
<div class="line"><a id="l00644" name="l00644"></a><span class="lineno">  644</span><span class="comment">// they are used to affect different mock objects.  The idea is that</span></div>
<div class="line"><a id="l00645" name="l00645"></a><span class="lineno">  645</span><span class="comment">// each thread can create and set up its own mocks as if it&#39;s the only</span></div>
<div class="line"><a id="l00646" name="l00646"></a><span class="lineno">  646</span><span class="comment">// thread.  However, for clarity of your tests we recommend you to set</span></div>
<div class="line"><a id="l00647" name="l00647"></a><span class="lineno">  647</span><span class="comment">// up mocks in the main thread unless you have a good reason not to do</span></div>
<div class="line"><a id="l00648" name="l00648"></a><span class="lineno">  648</span><span class="comment">// so.</span></div>
<div class="line"><a id="l00649" name="l00649"></a><span class="lineno">  649</span><span class="keyword">class </span>GTEST_API_ InSequence {</div>
<div class="line"><a id="l00650" name="l00650"></a><span class="lineno">  650</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00651" name="l00651"></a><span class="lineno">  651</span>  InSequence();</div>
<div class="line"><a id="l00652" name="l00652"></a><span class="lineno">  652</span>  ~InSequence();</div>
<div class="line"><a id="l00653" name="l00653"></a><span class="lineno">  653</span> </div>
<div class="line"><a id="l00654" name="l00654"></a><span class="lineno">  654</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00655" name="l00655"></a><span class="lineno">  655</span>  <span class="keywordtype">bool</span> sequence_created_;</div>
<div class="line"><a id="l00656" name="l00656"></a><span class="lineno">  656</span> </div>
<div class="line"><a id="l00657" name="l00657"></a><span class="lineno">  657</span>  InSequence(<span class="keyword">const</span> InSequence&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00658" name="l00658"></a><span class="lineno">  658</span>  InSequence&amp; operator=(<span class="keyword">const</span> InSequence&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l00659" name="l00659"></a><span class="lineno">  659</span>} GTEST_ATTRIBUTE_UNUSED_;</div>
<div class="line"><a id="l00660" name="l00660"></a><span class="lineno">  660</span> </div>
<div class="line"><a id="l00661" name="l00661"></a><span class="lineno">  661</span><span class="keyword">namespace </span>internal {</div>
<div class="line"><a id="l00662" name="l00662"></a><span class="lineno">  662</span> </div>
<div class="line"><a id="l00663" name="l00663"></a><span class="lineno">  663</span><span class="comment">// Points to the implicit sequence introduced by a living InSequence</span></div>
<div class="line"><a id="l00664" name="l00664"></a><span class="lineno">  664</span><span class="comment">// object (if any) in the current thread or NULL.</span></div>
<div class="line"><a id="l00665" name="l00665"></a><span class="lineno">  665</span>GTEST_API_ <span class="keyword">extern</span> ThreadLocal&lt;Sequence*&gt; g_gmock_implicit_sequence;</div>
<div class="line"><a id="l00666" name="l00666"></a><span class="lineno">  666</span> </div>
<div class="line"><a id="l00667" name="l00667"></a><span class="lineno">  667</span><span class="comment">// Base class for implementing expectations.</span></div>
<div class="line"><a id="l00668" name="l00668"></a><span class="lineno">  668</span><span class="comment">//</span></div>
<div class="line"><a id="l00669" name="l00669"></a><span class="lineno">  669</span><span class="comment">// There are two reasons for having a type-agnostic base class for</span></div>
<div class="line"><a id="l00670" name="l00670"></a><span class="lineno">  670</span><span class="comment">// Expectation:</span></div>
<div class="line"><a id="l00671" name="l00671"></a><span class="lineno">  671</span><span class="comment">//</span></div>
<div class="line"><a id="l00672" name="l00672"></a><span class="lineno">  672</span><span class="comment">//   1. We need to store collections of expectations of different</span></div>
<div class="line"><a id="l00673" name="l00673"></a><span class="lineno">  673</span><span class="comment">//   types (e.g. all pre-requisites of a particular expectation, all</span></div>
<div class="line"><a id="l00674" name="l00674"></a><span class="lineno">  674</span><span class="comment">//   expectations in a sequence).  Therefore these expectation objects</span></div>
<div class="line"><a id="l00675" name="l00675"></a><span class="lineno">  675</span><span class="comment">//   must share a common base class.</span></div>
<div class="line"><a id="l00676" name="l00676"></a><span class="lineno">  676</span><span class="comment">//</span></div>
<div class="line"><a id="l00677" name="l00677"></a><span class="lineno">  677</span><span class="comment">//   2. We can avoid binary code bloat by moving methods not depending</span></div>
<div class="line"><a id="l00678" name="l00678"></a><span class="lineno">  678</span><span class="comment">//   on the template argument of Expectation to the base class.</span></div>
<div class="line"><a id="l00679" name="l00679"></a><span class="lineno">  679</span><span class="comment">//</span></div>
<div class="line"><a id="l00680" name="l00680"></a><span class="lineno">  680</span><span class="comment">// This class is internal and mustn&#39;t be used by user code directly.</span></div>
<div class="line"><a id="l00681" name="l00681"></a><span class="lineno">  681</span><span class="keyword">class </span>GTEST_API_ ExpectationBase {</div>
<div class="line"><a id="l00682" name="l00682"></a><span class="lineno">  682</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00683" name="l00683"></a><span class="lineno">  683</span>  <span class="comment">// source_text is the EXPECT_CALL(...) source that created this Expectation.</span></div>
<div class="line"><a id="l00684" name="l00684"></a><span class="lineno">  684</span>  ExpectationBase(<span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line, <span class="keyword">const</span> std::string&amp; source_text);</div>
<div class="line"><a id="l00685" name="l00685"></a><span class="lineno">  685</span> </div>
<div class="line"><a id="l00686" name="l00686"></a><span class="lineno">  686</span>  <span class="keyword">virtual</span> ~ExpectationBase();</div>
<div class="line"><a id="l00687" name="l00687"></a><span class="lineno">  687</span> </div>
<div class="line"><a id="l00688" name="l00688"></a><span class="lineno">  688</span>  <span class="comment">// Where in the source file was the expectation spec defined?</span></div>
<div class="line"><a id="l00689" name="l00689"></a><span class="lineno">  689</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* file()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> file_; }</div>
<div class="line"><a id="l00690" name="l00690"></a><span class="lineno">  690</span>  <span class="keywordtype">int</span> line()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> line_; }</div>
<div class="line"><a id="l00691" name="l00691"></a><span class="lineno">  691</span>  <span class="keyword">const</span> <span class="keywordtype">char</span>* source_text()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> source_text_.c_str(); }</div>
<div class="line"><a id="l00692" name="l00692"></a><span class="lineno">  692</span>  <span class="comment">// Returns the cardinality specified in the expectation spec.</span></div>
<div class="line"><a id="l00693" name="l00693"></a><span class="lineno">  693</span>  <span class="keyword">const</span> Cardinality&amp; cardinality()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> cardinality_; }</div>
<div class="line"><a id="l00694" name="l00694"></a><span class="lineno">  694</span> </div>
<div class="line"><a id="l00695" name="l00695"></a><span class="lineno">  695</span>  <span class="comment">// Describes the source file location of this expectation.</span></div>
<div class="line"><a id="l00696" name="l00696"></a><span class="lineno">  696</span>  <span class="keywordtype">void</span> DescribeLocationTo(::std::ostream* os)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00697" name="l00697"></a><span class="lineno">  697</span>    *os &lt;&lt; FormatFileLocation(file(), line()) &lt;&lt; <span class="stringliteral">&quot; &quot;</span>;</div>
<div class="line"><a id="l00698" name="l00698"></a><span class="lineno">  698</span>  }</div>
<div class="line"><a id="l00699" name="l00699"></a><span class="lineno">  699</span> </div>
<div class="line"><a id="l00700" name="l00700"></a><span class="lineno">  700</span>  <span class="comment">// Describes how many times a function call matching this</span></div>
<div class="line"><a id="l00701" name="l00701"></a><span class="lineno">  701</span>  <span class="comment">// expectation has occurred.</span></div>
<div class="line"><a id="l00702" name="l00702"></a><span class="lineno">  702</span>  <span class="keywordtype">void</span> DescribeCallCountTo(::std::ostream* os) <span class="keyword">const</span></div>
<div class="line"><a id="l00703" name="l00703"></a><span class="lineno">  703</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex);</div>
<div class="line"><a id="l00704" name="l00704"></a><span class="lineno">  704</span> </div>
<div class="line"><a id="l00705" name="l00705"></a><span class="lineno">  705</span>  <span class="comment">// If this mock method has an extra matcher (i.e. .With(matcher)),</span></div>
<div class="line"><a id="l00706" name="l00706"></a><span class="lineno">  706</span>  <span class="comment">// describes it to the ostream.</span></div>
<div class="line"><a id="l00707" name="l00707"></a><span class="lineno">  707</span>  <span class="keyword">virtual</span> <span class="keywordtype">void</span> MaybeDescribeExtraMatcherTo(::std::ostream* os) = 0;</div>
<div class="line"><a id="l00708" name="l00708"></a><span class="lineno">  708</span> </div>
<div class="line"><a id="l00709" name="l00709"></a><span class="lineno">  709</span> <span class="keyword">protected</span>:</div>
<div class="line"><a id="l00710" name="l00710"></a><span class="lineno">  710</span>  <span class="keyword">friend</span> class ::testing::Expectation;</div>
<div class="line"><a id="l00711" name="l00711"></a><span class="lineno">  711</span>  <span class="keyword">friend</span> <span class="keyword">class </span>UntypedFunctionMockerBase;</div>
<div class="line"><a id="l00712" name="l00712"></a><span class="lineno">  712</span> </div>
<div class="line"><a id="l00713" name="l00713"></a><span class="lineno">  713</span>  <span class="keyword">enum</span> Clause {</div>
<div class="line"><a id="l00714" name="l00714"></a><span class="lineno">  714</span>    <span class="comment">// Don&#39;t change the order of the enum members!</span></div>
<div class="line"><a id="l00715" name="l00715"></a><span class="lineno">  715</span>    kNone,</div>
<div class="line"><a id="l00716" name="l00716"></a><span class="lineno">  716</span>    kWith,</div>
<div class="line"><a id="l00717" name="l00717"></a><span class="lineno">  717</span>    kTimes,</div>
<div class="line"><a id="l00718" name="l00718"></a><span class="lineno">  718</span>    kInSequence,</div>
<div class="line"><a id="l00719" name="l00719"></a><span class="lineno">  719</span>    kAfter,</div>
<div class="line"><a id="l00720" name="l00720"></a><span class="lineno">  720</span>    kWillOnce,</div>
<div class="line"><a id="l00721" name="l00721"></a><span class="lineno">  721</span>    kWillRepeatedly,</div>
<div class="line"><a id="l00722" name="l00722"></a><span class="lineno">  722</span>    kRetiresOnSaturation</div>
<div class="line"><a id="l00723" name="l00723"></a><span class="lineno">  723</span>  };</div>
<div class="line"><a id="l00724" name="l00724"></a><span class="lineno">  724</span> </div>
<div class="line"><a id="l00725" name="l00725"></a><span class="lineno">  725</span>  <span class="keyword">typedef</span> std::vector&lt;const void*&gt; UntypedActions;</div>
<div class="line"><a id="l00726" name="l00726"></a><span class="lineno">  726</span> </div>
<div class="line"><a id="l00727" name="l00727"></a><span class="lineno">  727</span>  <span class="comment">// Returns an Expectation object that references and co-owns this</span></div>
<div class="line"><a id="l00728" name="l00728"></a><span class="lineno">  728</span>  <span class="comment">// expectation.</span></div>
<div class="line"><a id="l00729" name="l00729"></a><span class="lineno">  729</span>  <span class="keyword">virtual</span> Expectation GetHandle() = 0;</div>
<div class="line"><a id="l00730" name="l00730"></a><span class="lineno">  730</span> </div>
<div class="line"><a id="l00731" name="l00731"></a><span class="lineno">  731</span>  <span class="comment">// Asserts that the EXPECT_CALL() statement has the given property.</span></div>
<div class="line"><a id="l00732" name="l00732"></a><span class="lineno">  732</span>  <span class="keywordtype">void</span> AssertSpecProperty(<span class="keywordtype">bool</span> property,</div>
<div class="line"><a id="l00733" name="l00733"></a><span class="lineno">  733</span>                          <span class="keyword">const</span> std::string&amp; failure_message)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00734" name="l00734"></a><span class="lineno">  734</span>    Assert(property, file_, line_, failure_message);</div>
<div class="line"><a id="l00735" name="l00735"></a><span class="lineno">  735</span>  }</div>
<div class="line"><a id="l00736" name="l00736"></a><span class="lineno">  736</span> </div>
<div class="line"><a id="l00737" name="l00737"></a><span class="lineno">  737</span>  <span class="comment">// Expects that the EXPECT_CALL() statement has the given property.</span></div>
<div class="line"><a id="l00738" name="l00738"></a><span class="lineno">  738</span>  <span class="keywordtype">void</span> ExpectSpecProperty(<span class="keywordtype">bool</span> property,</div>
<div class="line"><a id="l00739" name="l00739"></a><span class="lineno">  739</span>                          <span class="keyword">const</span> std::string&amp; failure_message)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l00740" name="l00740"></a><span class="lineno">  740</span>    Expect(property, file_, line_, failure_message);</div>
<div class="line"><a id="l00741" name="l00741"></a><span class="lineno">  741</span>  }</div>
<div class="line"><a id="l00742" name="l00742"></a><span class="lineno">  742</span> </div>
<div class="line"><a id="l00743" name="l00743"></a><span class="lineno">  743</span>  <span class="comment">// Explicitly specifies the cardinality of this expectation.  Used</span></div>
<div class="line"><a id="l00744" name="l00744"></a><span class="lineno">  744</span>  <span class="comment">// by the subclasses to implement the .Times() clause.</span></div>
<div class="line"><a id="l00745" name="l00745"></a><span class="lineno">  745</span>  <span class="keywordtype">void</span> SpecifyCardinality(<span class="keyword">const</span> Cardinality&amp; cardinality);</div>
<div class="line"><a id="l00746" name="l00746"></a><span class="lineno">  746</span> </div>
<div class="line"><a id="l00747" name="l00747"></a><span class="lineno">  747</span>  <span class="comment">// Returns true if and only if the user specified the cardinality</span></div>
<div class="line"><a id="l00748" name="l00748"></a><span class="lineno">  748</span>  <span class="comment">// explicitly using a .Times().</span></div>
<div class="line"><a id="l00749" name="l00749"></a><span class="lineno">  749</span>  <span class="keywordtype">bool</span> cardinality_specified()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> cardinality_specified_; }</div>
<div class="line"><a id="l00750" name="l00750"></a><span class="lineno">  750</span> </div>
<div class="line"><a id="l00751" name="l00751"></a><span class="lineno">  751</span>  <span class="comment">// Sets the cardinality of this expectation spec.</span></div>
<div class="line"><a id="l00752" name="l00752"></a><span class="lineno">  752</span>  <span class="keywordtype">void</span> set_cardinality(<span class="keyword">const</span> Cardinality&amp; a_cardinality) {</div>
<div class="line"><a id="l00753" name="l00753"></a><span class="lineno">  753</span>    cardinality_ = a_cardinality;</div>
<div class="line"><a id="l00754" name="l00754"></a><span class="lineno">  754</span>  }</div>
<div class="line"><a id="l00755" name="l00755"></a><span class="lineno">  755</span> </div>
<div class="line"><a id="l00756" name="l00756"></a><span class="lineno">  756</span>  <span class="comment">// The following group of methods should only be called after the</span></div>
<div class="line"><a id="l00757" name="l00757"></a><span class="lineno">  757</span>  <span class="comment">// EXPECT_CALL() statement, and only when g_gmock_mutex is held by</span></div>
<div class="line"><a id="l00758" name="l00758"></a><span class="lineno">  758</span>  <span class="comment">// the current thread.</span></div>
<div class="line"><a id="l00759" name="l00759"></a><span class="lineno">  759</span> </div>
<div class="line"><a id="l00760" name="l00760"></a><span class="lineno">  760</span>  <span class="comment">// Retires all pre-requisites of this expectation.</span></div>
<div class="line"><a id="l00761" name="l00761"></a><span class="lineno">  761</span>  <span class="keywordtype">void</span> RetireAllPreRequisites() GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex);</div>
<div class="line"><a id="l00762" name="l00762"></a><span class="lineno">  762</span> </div>
<div class="line"><a id="l00763" name="l00763"></a><span class="lineno">  763</span>  <span class="comment">// Returns true if and only if this expectation is retired.</span></div>
<div class="line"><a id="l00764" name="l00764"></a><span class="lineno">  764</span>  <span class="keywordtype">bool</span> is_retired() const GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l00765" name="l00765"></a><span class="lineno">  765</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l00766" name="l00766"></a><span class="lineno">  766</span>    <span class="keywordflow">return</span> retired_;</div>
<div class="line"><a id="l00767" name="l00767"></a><span class="lineno">  767</span>  }</div>
<div class="line"><a id="l00768" name="l00768"></a><span class="lineno">  768</span> </div>
<div class="line"><a id="l00769" name="l00769"></a><span class="lineno">  769</span>  <span class="comment">// Retires this expectation.</span></div>
<div class="line"><a id="l00770" name="l00770"></a><span class="lineno">  770</span>  <span class="keywordtype">void</span> Retire() GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l00771" name="l00771"></a><span class="lineno">  771</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l00772" name="l00772"></a><span class="lineno">  772</span>    retired_ = <span class="keyword">true</span>;</div>
<div class="line"><a id="l00773" name="l00773"></a><span class="lineno">  773</span>  }</div>
<div class="line"><a id="l00774" name="l00774"></a><span class="lineno">  774</span> </div>
<div class="line"><a id="l00775" name="l00775"></a><span class="lineno">  775</span>  <span class="comment">// Returns true if and only if this expectation is satisfied.</span></div>
<div class="line"><a id="l00776" name="l00776"></a><span class="lineno">  776</span>  <span class="keywordtype">bool</span> IsSatisfied() const GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l00777" name="l00777"></a><span class="lineno">  777</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l00778" name="l00778"></a><span class="lineno">  778</span>    <span class="keywordflow">return</span> cardinality().IsSatisfiedByCallCount(call_count_);</div>
<div class="line"><a id="l00779" name="l00779"></a><span class="lineno">  779</span>  }</div>
<div class="line"><a id="l00780" name="l00780"></a><span class="lineno">  780</span> </div>
<div class="line"><a id="l00781" name="l00781"></a><span class="lineno">  781</span>  <span class="comment">// Returns true if and only if this expectation is saturated.</span></div>
<div class="line"><a id="l00782" name="l00782"></a><span class="lineno">  782</span>  <span class="keywordtype">bool</span> IsSaturated() const GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l00783" name="l00783"></a><span class="lineno">  783</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l00784" name="l00784"></a><span class="lineno">  784</span>    <span class="keywordflow">return</span> cardinality().IsSaturatedByCallCount(call_count_);</div>
<div class="line"><a id="l00785" name="l00785"></a><span class="lineno">  785</span>  }</div>
<div class="line"><a id="l00786" name="l00786"></a><span class="lineno">  786</span> </div>
<div class="line"><a id="l00787" name="l00787"></a><span class="lineno">  787</span>  <span class="comment">// Returns true if and only if this expectation is over-saturated.</span></div>
<div class="line"><a id="l00788" name="l00788"></a><span class="lineno">  788</span>  <span class="keywordtype">bool</span> IsOverSaturated() const GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l00789" name="l00789"></a><span class="lineno">  789</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l00790" name="l00790"></a><span class="lineno">  790</span>    <span class="keywordflow">return</span> cardinality().IsOverSaturatedByCallCount(call_count_);</div>
<div class="line"><a id="l00791" name="l00791"></a><span class="lineno">  791</span>  }</div>
<div class="line"><a id="l00792" name="l00792"></a><span class="lineno">  792</span> </div>
<div class="line"><a id="l00793" name="l00793"></a><span class="lineno">  793</span>  <span class="comment">// Returns true if and only if all pre-requisites of this expectation are</span></div>
<div class="line"><a id="l00794" name="l00794"></a><span class="lineno">  794</span>  <span class="comment">// satisfied.</span></div>
<div class="line"><a id="l00795" name="l00795"></a><span class="lineno">  795</span>  <span class="keywordtype">bool</span> AllPrerequisitesAreSatisfied() const</div>
<div class="line"><a id="l00796" name="l00796"></a><span class="lineno">  796</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex);</div>
<div class="line"><a id="l00797" name="l00797"></a><span class="lineno">  797</span> </div>
<div class="line"><a id="l00798" name="l00798"></a><span class="lineno">  798</span>  <span class="comment">// Adds unsatisfied pre-requisites of this expectation to &#39;result&#39;.</span></div>
<div class="line"><a id="l00799" name="l00799"></a><span class="lineno">  799</span>  <span class="keywordtype">void</span> FindUnsatisfiedPrerequisites(ExpectationSet* result) const</div>
<div class="line"><a id="l00800" name="l00800"></a><span class="lineno">  800</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex);</div>
<div class="line"><a id="l00801" name="l00801"></a><span class="lineno">  801</span> </div>
<div class="line"><a id="l00802" name="l00802"></a><span class="lineno">  802</span>  <span class="comment">// Returns the number this expectation has been invoked.</span></div>
<div class="line"><a id="l00803" name="l00803"></a><span class="lineno">  803</span>  <span class="keywordtype">int</span> call_count() const GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l00804" name="l00804"></a><span class="lineno">  804</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l00805" name="l00805"></a><span class="lineno">  805</span>    <span class="keywordflow">return</span> call_count_;</div>
<div class="line"><a id="l00806" name="l00806"></a><span class="lineno">  806</span>  }</div>
<div class="line"><a id="l00807" name="l00807"></a><span class="lineno">  807</span> </div>
<div class="line"><a id="l00808" name="l00808"></a><span class="lineno">  808</span>  <span class="comment">// Increments the number this expectation has been invoked.</span></div>
<div class="line"><a id="l00809" name="l00809"></a><span class="lineno">  809</span>  <span class="keywordtype">void</span> IncrementCallCount() GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l00810" name="l00810"></a><span class="lineno">  810</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l00811" name="l00811"></a><span class="lineno">  811</span>    call_count_++;</div>
<div class="line"><a id="l00812" name="l00812"></a><span class="lineno">  812</span>  }</div>
<div class="line"><a id="l00813" name="l00813"></a><span class="lineno">  813</span> </div>
<div class="line"><a id="l00814" name="l00814"></a><span class="lineno">  814</span>  <span class="comment">// Checks the action count (i.e. the number of WillOnce() and</span></div>
<div class="line"><a id="l00815" name="l00815"></a><span class="lineno">  815</span>  <span class="comment">// WillRepeatedly() clauses) against the cardinality if this hasn&#39;t</span></div>
<div class="line"><a id="l00816" name="l00816"></a><span class="lineno">  816</span>  <span class="comment">// been done before.  Prints a warning if there are too many or too</span></div>
<div class="line"><a id="l00817" name="l00817"></a><span class="lineno">  817</span>  <span class="comment">// few actions.</span></div>
<div class="line"><a id="l00818" name="l00818"></a><span class="lineno">  818</span>  <span class="keywordtype">void</span> CheckActionCountIfNotDone() const GTEST_LOCK_EXCLUDED_(mutex_);</div>
<div class="line"><a id="l00819" name="l00819"></a><span class="lineno">  819</span> </div>
<div class="line"><a id="l00820" name="l00820"></a><span class="lineno">  820</span>  friend class ::testing::Sequence;</div>
<div class="line"><a id="l00821" name="l00821"></a><span class="lineno">  821</span>  friend class ::testing::internal::ExpectationTester;</div>
<div class="line"><a id="l00822" name="l00822"></a><span class="lineno">  822</span> </div>
<div class="line"><a id="l00823" name="l00823"></a><span class="lineno">  823</span>  template &lt;typename Function&gt;</div>
<div class="line"><a id="l00824" name="l00824"></a><span class="lineno">  824</span>  friend class TypedExpectation;</div>
<div class="line"><a id="l00825" name="l00825"></a><span class="lineno">  825</span> </div>
<div class="line"><a id="l00826" name="l00826"></a><span class="lineno">  826</span>  <span class="comment">// Implements the .Times() clause.</span></div>
<div class="line"><a id="l00827" name="l00827"></a><span class="lineno">  827</span>  <span class="keywordtype">void</span> UntypedTimes(const Cardinality&amp; a_cardinality);</div>
<div class="line"><a id="l00828" name="l00828"></a><span class="lineno">  828</span> </div>
<div class="line"><a id="l00829" name="l00829"></a><span class="lineno">  829</span>  <span class="comment">// This group of fields are part of the spec and won&#39;t change after</span></div>
<div class="line"><a id="l00830" name="l00830"></a><span class="lineno">  830</span>  <span class="comment">// an EXPECT_CALL() statement finishes.</span></div>
<div class="line"><a id="l00831" name="l00831"></a><span class="lineno">  831</span>  const <span class="keywordtype">char</span>* file_;               <span class="comment">// The file that contains the expectation.</span></div>
<div class="line"><a id="l00832" name="l00832"></a><span class="lineno">  832</span>  <span class="keywordtype">int</span> line_;                       <span class="comment">// The line number of the expectation.</span></div>
<div class="line"><a id="l00833" name="l00833"></a><span class="lineno">  833</span>  const std::<span class="keywordtype">string</span> source_text_;  <span class="comment">// The EXPECT_CALL(...) source text.</span></div>
<div class="line"><a id="l00834" name="l00834"></a><span class="lineno">  834</span>  <span class="comment">// True if and only if the cardinality is specified explicitly.</span></div>
<div class="line"><a id="l00835" name="l00835"></a><span class="lineno">  835</span>  <span class="keywordtype">bool</span> cardinality_specified_;</div>
<div class="line"><a id="l00836" name="l00836"></a><span class="lineno">  836</span>  Cardinality cardinality_;  <span class="comment">// The cardinality of the expectation.</span></div>
<div class="line"><a id="l00837" name="l00837"></a><span class="lineno">  837</span>  <span class="comment">// The immediate pre-requisites (i.e. expectations that must be</span></div>
<div class="line"><a id="l00838" name="l00838"></a><span class="lineno">  838</span>  <span class="comment">// satisfied before this expectation can be matched) of this</span></div>
<div class="line"><a id="l00839" name="l00839"></a><span class="lineno">  839</span>  <span class="comment">// expectation.  We use std::shared_ptr in the set because we want an</span></div>
<div class="line"><a id="l00840" name="l00840"></a><span class="lineno">  840</span>  <span class="comment">// Expectation object to be co-owned by its FunctionMocker and its</span></div>
<div class="line"><a id="l00841" name="l00841"></a><span class="lineno">  841</span>  <span class="comment">// successors.  This allows multiple mock objects to be deleted at</span></div>
<div class="line"><a id="l00842" name="l00842"></a><span class="lineno">  842</span>  <span class="comment">// different times.</span></div>
<div class="line"><a id="l00843" name="l00843"></a><span class="lineno">  843</span>  ExpectationSet immediate_prerequisites_;</div>
<div class="line"><a id="l00844" name="l00844"></a><span class="lineno">  844</span> </div>
<div class="line"><a id="l00845" name="l00845"></a><span class="lineno">  845</span>  <span class="comment">// This group of fields are the current state of the expectation,</span></div>
<div class="line"><a id="l00846" name="l00846"></a><span class="lineno">  846</span>  <span class="comment">// and can change as the mock function is called.</span></div>
<div class="line"><a id="l00847" name="l00847"></a><span class="lineno">  847</span>  <span class="keywordtype">int</span> call_count_;  <span class="comment">// How many times this expectation has been invoked.</span></div>
<div class="line"><a id="l00848" name="l00848"></a><span class="lineno">  848</span>  <span class="keywordtype">bool</span> retired_;    <span class="comment">// True if and only if this expectation has retired.</span></div>
<div class="line"><a id="l00849" name="l00849"></a><span class="lineno">  849</span>  UntypedActions untyped_actions_;</div>
<div class="line"><a id="l00850" name="l00850"></a><span class="lineno">  850</span>  <span class="keywordtype">bool</span> extra_matcher_specified_;</div>
<div class="line"><a id="l00851" name="l00851"></a><span class="lineno">  851</span>  <span class="keywordtype">bool</span> repeated_action_specified_;  <span class="comment">// True if a WillRepeatedly() was specified.</span></div>
<div class="line"><a id="l00852" name="l00852"></a><span class="lineno">  852</span>  <span class="keywordtype">bool</span> retires_on_saturation_;</div>
<div class="line"><a id="l00853" name="l00853"></a><span class="lineno">  853</span>  Clause last_clause_;</div>
<div class="line"><a id="l00854" name="l00854"></a><span class="lineno">  854</span>  mutable <span class="keywordtype">bool</span> action_count_checked_;  <span class="comment">// Under mutex_.</span></div>
<div class="line"><a id="l00855" name="l00855"></a><span class="lineno">  855</span>  mutable Mutex mutex_;                <span class="comment">// Protects action_count_checked_.</span></div>
<div class="line"><a id="l00856" name="l00856"></a><span class="lineno">  856</span>};                                     <span class="comment">// class ExpectationBase</span></div>
<div class="line"><a id="l00857" name="l00857"></a><span class="lineno">  857</span> </div>
<div class="line"><a id="l00858" name="l00858"></a><span class="lineno">  858</span>template &lt;typename F&gt;</div>
<div class="line"><a id="l00859" name="l00859"></a><span class="lineno">  859</span>class TypedExpectation;</div>
<div class="line"><a id="l00860" name="l00860"></a><span class="lineno">  860</span> </div>
<div class="line"><a id="l00861" name="l00861"></a><span class="lineno">  861</span><span class="comment">// Implements an expectation for the given function type.</span></div>
<div class="line"><a id="l00862" name="l00862"></a><span class="lineno">  862</span>template &lt;typename R, typename... Args&gt;</div>
<div class="line"><a id="l00863" name="l00863"></a><span class="lineno">  863</span>class TypedExpectation&lt;R(Args...)&gt; : public ExpectationBase {</div>
<div class="line"><a id="l00864" name="l00864"></a><span class="lineno">  864</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l00865" name="l00865"></a><span class="lineno">  865</span>  <span class="keyword">using </span>F = R(Args...);</div>
<div class="line"><a id="l00866" name="l00866"></a><span class="lineno">  866</span> </div>
<div class="line"><a id="l00867" name="l00867"></a><span class="lineno">  867</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l00868" name="l00868"></a><span class="lineno">  868</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> Function&lt;F&gt;::ArgumentTuple ArgumentTuple;</div>
<div class="line"><a id="l00869" name="l00869"></a><span class="lineno">  869</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> Function&lt;F&gt;::ArgumentMatcherTuple ArgumentMatcherTuple;</div>
<div class="line"><a id="l00870" name="l00870"></a><span class="lineno">  870</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> Function&lt;F&gt;::Result Result;</div>
<div class="line"><a id="l00871" name="l00871"></a><span class="lineno">  871</span> </div>
<div class="line"><a id="l00872" name="l00872"></a><span class="lineno">  872</span>  TypedExpectation(FunctionMocker&lt;F&gt;* owner, <span class="keyword">const</span> <span class="keywordtype">char</span>* a_file, <span class="keywordtype">int</span> a_line,</div>
<div class="line"><a id="l00873" name="l00873"></a><span class="lineno">  873</span>                   <span class="keyword">const</span> std::string&amp; a_source_text,</div>
<div class="line"><a id="l00874" name="l00874"></a><span class="lineno">  874</span>                   <span class="keyword">const</span> ArgumentMatcherTuple&amp; m)</div>
<div class="line"><a id="l00875" name="l00875"></a><span class="lineno">  875</span>      : ExpectationBase(a_file, a_line, a_source_text),</div>
<div class="line"><a id="l00876" name="l00876"></a><span class="lineno">  876</span>        owner_(owner),</div>
<div class="line"><a id="l00877" name="l00877"></a><span class="lineno">  877</span>        matchers_(m),</div>
<div class="line"><a id="l00878" name="l00878"></a><span class="lineno">  878</span>        <span class="comment">// By default, extra_matcher_ should match anything.  However,</span></div>
<div class="line"><a id="l00879" name="l00879"></a><span class="lineno">  879</span>        <span class="comment">// we cannot initialize it with _ as that causes ambiguity between</span></div>
<div class="line"><a id="l00880" name="l00880"></a><span class="lineno">  880</span>        <span class="comment">// Matcher&#39;s copy and move constructor for some argument types.</span></div>
<div class="line"><a id="l00881" name="l00881"></a><span class="lineno">  881</span>        extra_matcher_(A&lt;const ArgumentTuple&amp;&gt;()),</div>
<div class="line"><a id="l00882" name="l00882"></a><span class="lineno">  882</span>        repeated_action_(DoDefault()) {}</div>
<div class="line"><a id="l00883" name="l00883"></a><span class="lineno">  883</span> </div>
<div class="line"><a id="l00884" name="l00884"></a><span class="lineno">  884</span>  ~TypedExpectation()<span class="keyword"> override </span>{</div>
<div class="line"><a id="l00885" name="l00885"></a><span class="lineno">  885</span>    <span class="comment">// Check the validity of the action count if it hasn&#39;t been done</span></div>
<div class="line"><a id="l00886" name="l00886"></a><span class="lineno">  886</span>    <span class="comment">// yet (for example, if the expectation was never used).</span></div>
<div class="line"><a id="l00887" name="l00887"></a><span class="lineno">  887</span>    CheckActionCountIfNotDone();</div>
<div class="line"><a id="l00888" name="l00888"></a><span class="lineno">  888</span>    <span class="keywordflow">for</span> (UntypedActions::const_iterator it = untyped_actions_.begin();</div>
<div class="line"><a id="l00889" name="l00889"></a><span class="lineno">  889</span>         it != untyped_actions_.end(); ++it) {</div>
<div class="line"><a id="l00890" name="l00890"></a><span class="lineno">  890</span>      <span class="keyword">delete</span> <span class="keyword">static_cast&lt;</span><span class="keyword">const </span>Action&lt;F&gt;*<span class="keyword">&gt;</span>(*it);</div>
<div class="line"><a id="l00891" name="l00891"></a><span class="lineno">  891</span>    }</div>
<div class="line"><a id="l00892" name="l00892"></a><span class="lineno">  892</span>  }</div>
<div class="line"><a id="l00893" name="l00893"></a><span class="lineno">  893</span> </div>
<div class="line"><a id="l00894" name="l00894"></a><span class="lineno">  894</span>  <span class="comment">// Implements the .With() clause.</span></div>
<div class="line"><a id="l00895" name="l00895"></a><span class="lineno">  895</span>  TypedExpectation&amp; With(<span class="keyword">const</span> Matcher&lt;const ArgumentTuple&amp;&gt;&amp; m) {</div>
<div class="line"><a id="l00896" name="l00896"></a><span class="lineno">  896</span>    <span class="keywordflow">if</span> (last_clause_ == kWith) {</div>
<div class="line"><a id="l00897" name="l00897"></a><span class="lineno">  897</span>      ExpectSpecProperty(<span class="keyword">false</span>,</div>
<div class="line"><a id="l00898" name="l00898"></a><span class="lineno">  898</span>                         <span class="stringliteral">&quot;.With() cannot appear &quot;</span></div>
<div class="line"><a id="l00899" name="l00899"></a><span class="lineno">  899</span>                         <span class="stringliteral">&quot;more than once in an EXPECT_CALL().&quot;</span>);</div>
<div class="line"><a id="l00900" name="l00900"></a><span class="lineno">  900</span>    } <span class="keywordflow">else</span> {</div>
<div class="line"><a id="l00901" name="l00901"></a><span class="lineno">  901</span>      ExpectSpecProperty(last_clause_ &lt; kWith,</div>
<div class="line"><a id="l00902" name="l00902"></a><span class="lineno">  902</span>                         <span class="stringliteral">&quot;.With() must be the first &quot;</span></div>
<div class="line"><a id="l00903" name="l00903"></a><span class="lineno">  903</span>                         <span class="stringliteral">&quot;clause in an EXPECT_CALL().&quot;</span>);</div>
<div class="line"><a id="l00904" name="l00904"></a><span class="lineno">  904</span>    }</div>
<div class="line"><a id="l00905" name="l00905"></a><span class="lineno">  905</span>    last_clause_ = kWith;</div>
<div class="line"><a id="l00906" name="l00906"></a><span class="lineno">  906</span> </div>
<div class="line"><a id="l00907" name="l00907"></a><span class="lineno">  907</span>    extra_matcher_ = m;</div>
<div class="line"><a id="l00908" name="l00908"></a><span class="lineno">  908</span>    extra_matcher_specified_ = <span class="keyword">true</span>;</div>
<div class="line"><a id="l00909" name="l00909"></a><span class="lineno">  909</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l00910" name="l00910"></a><span class="lineno">  910</span>  }</div>
<div class="line"><a id="l00911" name="l00911"></a><span class="lineno">  911</span> </div>
<div class="line"><a id="l00912" name="l00912"></a><span class="lineno">  912</span>  <span class="comment">// Implements the .Times() clause.</span></div>
<div class="line"><a id="l00913" name="l00913"></a><span class="lineno">  913</span>  TypedExpectation&amp; Times(<span class="keyword">const</span> Cardinality&amp; a_cardinality) {</div>
<div class="line"><a id="l00914" name="l00914"></a><span class="lineno">  914</span>    ExpectationBase::UntypedTimes(a_cardinality);</div>
<div class="line"><a id="l00915" name="l00915"></a><span class="lineno">  915</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l00916" name="l00916"></a><span class="lineno">  916</span>  }</div>
<div class="line"><a id="l00917" name="l00917"></a><span class="lineno">  917</span> </div>
<div class="line"><a id="l00918" name="l00918"></a><span class="lineno">  918</span>  <span class="comment">// Implements the .Times() clause.</span></div>
<div class="line"><a id="l00919" name="l00919"></a><span class="lineno">  919</span>  TypedExpectation&amp; Times(<span class="keywordtype">int</span> n) { <span class="keywordflow">return</span> Times(Exactly(n)); }</div>
<div class="line"><a id="l00920" name="l00920"></a><span class="lineno">  920</span> </div>
<div class="line"><a id="l00921" name="l00921"></a><span class="lineno">  921</span>  <span class="comment">// Implements the .InSequence() clause.</span></div>
<div class="line"><a id="l00922" name="l00922"></a><span class="lineno">  922</span>  TypedExpectation&amp; InSequence(<span class="keyword">const</span> Sequence&amp; s) {</div>
<div class="line"><a id="l00923" name="l00923"></a><span class="lineno">  923</span>    ExpectSpecProperty(last_clause_ &lt;= kInSequence,</div>
<div class="line"><a id="l00924" name="l00924"></a><span class="lineno">  924</span>                       <span class="stringliteral">&quot;.InSequence() cannot appear after .After(),&quot;</span></div>
<div class="line"><a id="l00925" name="l00925"></a><span class="lineno">  925</span>                       <span class="stringliteral">&quot; .WillOnce(), .WillRepeatedly(), or &quot;</span></div>
<div class="line"><a id="l00926" name="l00926"></a><span class="lineno">  926</span>                       <span class="stringliteral">&quot;.RetiresOnSaturation().&quot;</span>);</div>
<div class="line"><a id="l00927" name="l00927"></a><span class="lineno">  927</span>    last_clause_ = kInSequence;</div>
<div class="line"><a id="l00928" name="l00928"></a><span class="lineno">  928</span> </div>
<div class="line"><a id="l00929" name="l00929"></a><span class="lineno">  929</span>    s.AddExpectation(GetHandle());</div>
<div class="line"><a id="l00930" name="l00930"></a><span class="lineno">  930</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l00931" name="l00931"></a><span class="lineno">  931</span>  }</div>
<div class="line"><a id="l00932" name="l00932"></a><span class="lineno">  932</span>  TypedExpectation&amp; InSequence(<span class="keyword">const</span> Sequence&amp; s1, <span class="keyword">const</span> Sequence&amp; s2) {</div>
<div class="line"><a id="l00933" name="l00933"></a><span class="lineno">  933</span>    <span class="keywordflow">return</span> InSequence(s1).InSequence(s2);</div>
<div class="line"><a id="l00934" name="l00934"></a><span class="lineno">  934</span>  }</div>
<div class="line"><a id="l00935" name="l00935"></a><span class="lineno">  935</span>  TypedExpectation&amp; InSequence(<span class="keyword">const</span> Sequence&amp; s1, <span class="keyword">const</span> Sequence&amp; s2,</div>
<div class="line"><a id="l00936" name="l00936"></a><span class="lineno">  936</span>                               <span class="keyword">const</span> Sequence&amp; s3) {</div>
<div class="line"><a id="l00937" name="l00937"></a><span class="lineno">  937</span>    <span class="keywordflow">return</span> InSequence(s1, s2).InSequence(s3);</div>
<div class="line"><a id="l00938" name="l00938"></a><span class="lineno">  938</span>  }</div>
<div class="line"><a id="l00939" name="l00939"></a><span class="lineno">  939</span>  TypedExpectation&amp; InSequence(<span class="keyword">const</span> Sequence&amp; s1, <span class="keyword">const</span> Sequence&amp; s2,</div>
<div class="line"><a id="l00940" name="l00940"></a><span class="lineno">  940</span>                               <span class="keyword">const</span> Sequence&amp; s3, <span class="keyword">const</span> Sequence&amp; s4) {</div>
<div class="line"><a id="l00941" name="l00941"></a><span class="lineno">  941</span>    <span class="keywordflow">return</span> InSequence(s1, s2, s3).InSequence(s4);</div>
<div class="line"><a id="l00942" name="l00942"></a><span class="lineno">  942</span>  }</div>
<div class="line"><a id="l00943" name="l00943"></a><span class="lineno">  943</span>  TypedExpectation&amp; InSequence(<span class="keyword">const</span> Sequence&amp; s1, <span class="keyword">const</span> Sequence&amp; s2,</div>
<div class="line"><a id="l00944" name="l00944"></a><span class="lineno">  944</span>                               <span class="keyword">const</span> Sequence&amp; s3, <span class="keyword">const</span> Sequence&amp; s4,</div>
<div class="line"><a id="l00945" name="l00945"></a><span class="lineno">  945</span>                               <span class="keyword">const</span> Sequence&amp; s5) {</div>
<div class="line"><a id="l00946" name="l00946"></a><span class="lineno">  946</span>    <span class="keywordflow">return</span> InSequence(s1, s2, s3, s4).InSequence(s5);</div>
<div class="line"><a id="l00947" name="l00947"></a><span class="lineno">  947</span>  }</div>
<div class="line"><a id="l00948" name="l00948"></a><span class="lineno">  948</span> </div>
<div class="line"><a id="l00949" name="l00949"></a><span class="lineno">  949</span>  <span class="comment">// Implements that .After() clause.</span></div>
<div class="line"><a id="l00950" name="l00950"></a><span class="lineno">  950</span>  TypedExpectation&amp; After(<span class="keyword">const</span> ExpectationSet&amp; s) {</div>
<div class="line"><a id="l00951" name="l00951"></a><span class="lineno">  951</span>    ExpectSpecProperty(last_clause_ &lt;= kAfter,</div>
<div class="line"><a id="l00952" name="l00952"></a><span class="lineno">  952</span>                       <span class="stringliteral">&quot;.After() cannot appear after .WillOnce(),&quot;</span></div>
<div class="line"><a id="l00953" name="l00953"></a><span class="lineno">  953</span>                       <span class="stringliteral">&quot; .WillRepeatedly(), or &quot;</span></div>
<div class="line"><a id="l00954" name="l00954"></a><span class="lineno">  954</span>                       <span class="stringliteral">&quot;.RetiresOnSaturation().&quot;</span>);</div>
<div class="line"><a id="l00955" name="l00955"></a><span class="lineno">  955</span>    last_clause_ = kAfter;</div>
<div class="line"><a id="l00956" name="l00956"></a><span class="lineno">  956</span> </div>
<div class="line"><a id="l00957" name="l00957"></a><span class="lineno">  957</span>    <span class="keywordflow">for</span> (ExpectationSet::const_iterator it = s.begin(); it != s.end(); ++it) {</div>
<div class="line"><a id="l00958" name="l00958"></a><span class="lineno">  958</span>      immediate_prerequisites_ += *it;</div>
<div class="line"><a id="l00959" name="l00959"></a><span class="lineno">  959</span>    }</div>
<div class="line"><a id="l00960" name="l00960"></a><span class="lineno">  960</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l00961" name="l00961"></a><span class="lineno">  961</span>  }</div>
<div class="line"><a id="l00962" name="l00962"></a><span class="lineno">  962</span>  TypedExpectation&amp; After(<span class="keyword">const</span> ExpectationSet&amp; s1, <span class="keyword">const</span> ExpectationSet&amp; s2) {</div>
<div class="line"><a id="l00963" name="l00963"></a><span class="lineno">  963</span>    <span class="keywordflow">return</span> After(s1).After(s2);</div>
<div class="line"><a id="l00964" name="l00964"></a><span class="lineno">  964</span>  }</div>
<div class="line"><a id="l00965" name="l00965"></a><span class="lineno">  965</span>  TypedExpectation&amp; After(<span class="keyword">const</span> ExpectationSet&amp; s1, <span class="keyword">const</span> ExpectationSet&amp; s2,</div>
<div class="line"><a id="l00966" name="l00966"></a><span class="lineno">  966</span>                          <span class="keyword">const</span> ExpectationSet&amp; s3) {</div>
<div class="line"><a id="l00967" name="l00967"></a><span class="lineno">  967</span>    <span class="keywordflow">return</span> After(s1, s2).After(s3);</div>
<div class="line"><a id="l00968" name="l00968"></a><span class="lineno">  968</span>  }</div>
<div class="line"><a id="l00969" name="l00969"></a><span class="lineno">  969</span>  TypedExpectation&amp; After(<span class="keyword">const</span> ExpectationSet&amp; s1, <span class="keyword">const</span> ExpectationSet&amp; s2,</div>
<div class="line"><a id="l00970" name="l00970"></a><span class="lineno">  970</span>                          <span class="keyword">const</span> ExpectationSet&amp; s3, <span class="keyword">const</span> ExpectationSet&amp; s4) {</div>
<div class="line"><a id="l00971" name="l00971"></a><span class="lineno">  971</span>    <span class="keywordflow">return</span> After(s1, s2, s3).After(s4);</div>
<div class="line"><a id="l00972" name="l00972"></a><span class="lineno">  972</span>  }</div>
<div class="line"><a id="l00973" name="l00973"></a><span class="lineno">  973</span>  TypedExpectation&amp; After(<span class="keyword">const</span> ExpectationSet&amp; s1, <span class="keyword">const</span> ExpectationSet&amp; s2,</div>
<div class="line"><a id="l00974" name="l00974"></a><span class="lineno">  974</span>                          <span class="keyword">const</span> ExpectationSet&amp; s3, <span class="keyword">const</span> ExpectationSet&amp; s4,</div>
<div class="line"><a id="l00975" name="l00975"></a><span class="lineno">  975</span>                          <span class="keyword">const</span> ExpectationSet&amp; s5) {</div>
<div class="line"><a id="l00976" name="l00976"></a><span class="lineno">  976</span>    <span class="keywordflow">return</span> After(s1, s2, s3, s4).After(s5);</div>
<div class="line"><a id="l00977" name="l00977"></a><span class="lineno">  977</span>  }</div>
<div class="line"><a id="l00978" name="l00978"></a><span class="lineno">  978</span> </div>
<div class="line"><a id="l00979" name="l00979"></a><span class="lineno">  979</span>  <span class="comment">// Preferred, type-safe overload: consume anything that can be directly</span></div>
<div class="line"><a id="l00980" name="l00980"></a><span class="lineno">  980</span>  <span class="comment">// converted to a OnceAction, except for Action&lt;F&gt; objects themselves.</span></div>
<div class="line"><a id="l00981" name="l00981"></a><span class="lineno">  981</span>  TypedExpectation&amp; WillOnce(OnceAction&lt;F&gt; once_action) {</div>
<div class="line"><a id="l00982" name="l00982"></a><span class="lineno">  982</span>    <span class="comment">// Call the overload below, smuggling the OnceAction as a copyable callable.</span></div>
<div class="line"><a id="l00983" name="l00983"></a><span class="lineno">  983</span>    <span class="comment">// We know this is safe because a WillOnce action will not be called more</span></div>
<div class="line"><a id="l00984" name="l00984"></a><span class="lineno">  984</span>    <span class="comment">// than once.</span></div>
<div class="line"><a id="l00985" name="l00985"></a><span class="lineno">  985</span>    <span class="keywordflow">return</span> WillOnce(Action&lt;F&gt;(ActionAdaptor{</div>
<div class="line"><a id="l00986" name="l00986"></a><span class="lineno">  986</span>        std::make_shared&lt;OnceAction&lt;F&gt;&gt;(std::move(once_action)),</div>
<div class="line"><a id="l00987" name="l00987"></a><span class="lineno">  987</span>    }));</div>
<div class="line"><a id="l00988" name="l00988"></a><span class="lineno">  988</span>  }</div>
<div class="line"><a id="l00989" name="l00989"></a><span class="lineno">  989</span> </div>
<div class="line"><a id="l00990" name="l00990"></a><span class="lineno">  990</span>  <span class="comment">// Fallback overload: accept Action&lt;F&gt; objects and those actions that define</span></div>
<div class="line"><a id="l00991" name="l00991"></a><span class="lineno">  991</span>  <span class="comment">// `operator Action&lt;F&gt;` but not `operator OnceAction&lt;F&gt;`.</span></div>
<div class="line"><a id="l00992" name="l00992"></a><span class="lineno">  992</span>  <span class="comment">//</span></div>
<div class="line"><a id="l00993" name="l00993"></a><span class="lineno">  993</span>  <span class="comment">// This is templated in order to cause the overload above to be preferred</span></div>
<div class="line"><a id="l00994" name="l00994"></a><span class="lineno">  994</span>  <span class="comment">// when the input is convertible to either type.</span></div>
<div class="line"><a id="l00995" name="l00995"></a><span class="lineno">  995</span>  <span class="keyword">template</span> &lt;<span class="keywordtype">int</span>&amp;... ExplicitArgumentBarrier, <span class="keyword">typename</span> = <span class="keywordtype">void</span>&gt;</div>
<div class="line"><a id="l00996" name="l00996"></a><span class="lineno">  996</span>  TypedExpectation&amp; WillOnce(Action&lt;F&gt; action) {</div>
<div class="line"><a id="l00997" name="l00997"></a><span class="lineno">  997</span>    ExpectSpecProperty(last_clause_ &lt;= kWillOnce,</div>
<div class="line"><a id="l00998" name="l00998"></a><span class="lineno">  998</span>                       <span class="stringliteral">&quot;.WillOnce() cannot appear after &quot;</span></div>
<div class="line"><a id="l00999" name="l00999"></a><span class="lineno">  999</span>                       <span class="stringliteral">&quot;.WillRepeatedly() or .RetiresOnSaturation().&quot;</span>);</div>
<div class="line"><a id="l01000" name="l01000"></a><span class="lineno"> 1000</span>    last_clause_ = kWillOnce;</div>
<div class="line"><a id="l01001" name="l01001"></a><span class="lineno"> 1001</span> </div>
<div class="line"><a id="l01002" name="l01002"></a><span class="lineno"> 1002</span>    untyped_actions_.push_back(<span class="keyword">new</span> Action&lt;F&gt;(std::move(action)));</div>
<div class="line"><a id="l01003" name="l01003"></a><span class="lineno"> 1003</span> </div>
<div class="line"><a id="l01004" name="l01004"></a><span class="lineno"> 1004</span>    <span class="keywordflow">if</span> (!cardinality_specified()) {</div>
<div class="line"><a id="l01005" name="l01005"></a><span class="lineno"> 1005</span>      set_cardinality(Exactly(<span class="keyword">static_cast&lt;</span><span class="keywordtype">int</span><span class="keyword">&gt;</span>(untyped_actions_.size())));</div>
<div class="line"><a id="l01006" name="l01006"></a><span class="lineno"> 1006</span>    }</div>
<div class="line"><a id="l01007" name="l01007"></a><span class="lineno"> 1007</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l01008" name="l01008"></a><span class="lineno"> 1008</span>  }</div>
<div class="line"><a id="l01009" name="l01009"></a><span class="lineno"> 1009</span> </div>
<div class="line"><a id="l01010" name="l01010"></a><span class="lineno"> 1010</span>  <span class="comment">// Implements the .WillRepeatedly() clause.</span></div>
<div class="line"><a id="l01011" name="l01011"></a><span class="lineno"> 1011</span>  TypedExpectation&amp; WillRepeatedly(<span class="keyword">const</span> Action&lt;F&gt;&amp; action) {</div>
<div class="line"><a id="l01012" name="l01012"></a><span class="lineno"> 1012</span>    <span class="keywordflow">if</span> (last_clause_ == kWillRepeatedly) {</div>
<div class="line"><a id="l01013" name="l01013"></a><span class="lineno"> 1013</span>      ExpectSpecProperty(<span class="keyword">false</span>,</div>
<div class="line"><a id="l01014" name="l01014"></a><span class="lineno"> 1014</span>                         <span class="stringliteral">&quot;.WillRepeatedly() cannot appear &quot;</span></div>
<div class="line"><a id="l01015" name="l01015"></a><span class="lineno"> 1015</span>                         <span class="stringliteral">&quot;more than once in an EXPECT_CALL().&quot;</span>);</div>
<div class="line"><a id="l01016" name="l01016"></a><span class="lineno"> 1016</span>    } <span class="keywordflow">else</span> {</div>
<div class="line"><a id="l01017" name="l01017"></a><span class="lineno"> 1017</span>      ExpectSpecProperty(last_clause_ &lt; kWillRepeatedly,</div>
<div class="line"><a id="l01018" name="l01018"></a><span class="lineno"> 1018</span>                         <span class="stringliteral">&quot;.WillRepeatedly() cannot appear &quot;</span></div>
<div class="line"><a id="l01019" name="l01019"></a><span class="lineno"> 1019</span>                         <span class="stringliteral">&quot;after .RetiresOnSaturation().&quot;</span>);</div>
<div class="line"><a id="l01020" name="l01020"></a><span class="lineno"> 1020</span>    }</div>
<div class="line"><a id="l01021" name="l01021"></a><span class="lineno"> 1021</span>    last_clause_ = kWillRepeatedly;</div>
<div class="line"><a id="l01022" name="l01022"></a><span class="lineno"> 1022</span>    repeated_action_specified_ = <span class="keyword">true</span>;</div>
<div class="line"><a id="l01023" name="l01023"></a><span class="lineno"> 1023</span> </div>
<div class="line"><a id="l01024" name="l01024"></a><span class="lineno"> 1024</span>    repeated_action_ = action;</div>
<div class="line"><a id="l01025" name="l01025"></a><span class="lineno"> 1025</span>    <span class="keywordflow">if</span> (!cardinality_specified()) {</div>
<div class="line"><a id="l01026" name="l01026"></a><span class="lineno"> 1026</span>      set_cardinality(AtLeast(<span class="keyword">static_cast&lt;</span><span class="keywordtype">int</span><span class="keyword">&gt;</span>(untyped_actions_.size())));</div>
<div class="line"><a id="l01027" name="l01027"></a><span class="lineno"> 1027</span>    }</div>
<div class="line"><a id="l01028" name="l01028"></a><span class="lineno"> 1028</span> </div>
<div class="line"><a id="l01029" name="l01029"></a><span class="lineno"> 1029</span>    <span class="comment">// Now that no more action clauses can be specified, we check</span></div>
<div class="line"><a id="l01030" name="l01030"></a><span class="lineno"> 1030</span>    <span class="comment">// whether their count makes sense.</span></div>
<div class="line"><a id="l01031" name="l01031"></a><span class="lineno"> 1031</span>    CheckActionCountIfNotDone();</div>
<div class="line"><a id="l01032" name="l01032"></a><span class="lineno"> 1032</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l01033" name="l01033"></a><span class="lineno"> 1033</span>  }</div>
<div class="line"><a id="l01034" name="l01034"></a><span class="lineno"> 1034</span> </div>
<div class="line"><a id="l01035" name="l01035"></a><span class="lineno"> 1035</span>  <span class="comment">// Implements the .RetiresOnSaturation() clause.</span></div>
<div class="line"><a id="l01036" name="l01036"></a><span class="lineno"> 1036</span>  TypedExpectation&amp; RetiresOnSaturation() {</div>
<div class="line"><a id="l01037" name="l01037"></a><span class="lineno"> 1037</span>    ExpectSpecProperty(last_clause_ &lt; kRetiresOnSaturation,</div>
<div class="line"><a id="l01038" name="l01038"></a><span class="lineno"> 1038</span>                       <span class="stringliteral">&quot;.RetiresOnSaturation() cannot appear &quot;</span></div>
<div class="line"><a id="l01039" name="l01039"></a><span class="lineno"> 1039</span>                       <span class="stringliteral">&quot;more than once.&quot;</span>);</div>
<div class="line"><a id="l01040" name="l01040"></a><span class="lineno"> 1040</span>    last_clause_ = kRetiresOnSaturation;</div>
<div class="line"><a id="l01041" name="l01041"></a><span class="lineno"> 1041</span>    retires_on_saturation_ = <span class="keyword">true</span>;</div>
<div class="line"><a id="l01042" name="l01042"></a><span class="lineno"> 1042</span> </div>
<div class="line"><a id="l01043" name="l01043"></a><span class="lineno"> 1043</span>    <span class="comment">// Now that no more action clauses can be specified, we check</span></div>
<div class="line"><a id="l01044" name="l01044"></a><span class="lineno"> 1044</span>    <span class="comment">// whether their count makes sense.</span></div>
<div class="line"><a id="l01045" name="l01045"></a><span class="lineno"> 1045</span>    CheckActionCountIfNotDone();</div>
<div class="line"><a id="l01046" name="l01046"></a><span class="lineno"> 1046</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l01047" name="l01047"></a><span class="lineno"> 1047</span>  }</div>
<div class="line"><a id="l01048" name="l01048"></a><span class="lineno"> 1048</span> </div>
<div class="line"><a id="l01049" name="l01049"></a><span class="lineno"> 1049</span>  <span class="comment">// Returns the matchers for the arguments as specified inside the</span></div>
<div class="line"><a id="l01050" name="l01050"></a><span class="lineno"> 1050</span>  <span class="comment">// EXPECT_CALL() macro.</span></div>
<div class="line"><a id="l01051" name="l01051"></a><span class="lineno"> 1051</span>  <span class="keyword">const</span> ArgumentMatcherTuple&amp; matchers()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> matchers_; }</div>
<div class="line"><a id="l01052" name="l01052"></a><span class="lineno"> 1052</span> </div>
<div class="line"><a id="l01053" name="l01053"></a><span class="lineno"> 1053</span>  <span class="comment">// Returns the matcher specified by the .With() clause.</span></div>
<div class="line"><a id="l01054" name="l01054"></a><span class="lineno"> 1054</span>  <span class="keyword">const</span> Matcher&lt;const ArgumentTuple&amp;&gt;&amp; extra_matcher()<span class="keyword"> const </span>{</div>
<div class="line"><a id="l01055" name="l01055"></a><span class="lineno"> 1055</span>    <span class="keywordflow">return</span> extra_matcher_;</div>
<div class="line"><a id="l01056" name="l01056"></a><span class="lineno"> 1056</span>  }</div>
<div class="line"><a id="l01057" name="l01057"></a><span class="lineno"> 1057</span> </div>
<div class="line"><a id="l01058" name="l01058"></a><span class="lineno"> 1058</span>  <span class="comment">// Returns the action specified by the .WillRepeatedly() clause.</span></div>
<div class="line"><a id="l01059" name="l01059"></a><span class="lineno"> 1059</span>  <span class="keyword">const</span> Action&lt;F&gt;&amp; repeated_action()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> repeated_action_; }</div>
<div class="line"><a id="l01060" name="l01060"></a><span class="lineno"> 1060</span> </div>
<div class="line"><a id="l01061" name="l01061"></a><span class="lineno"> 1061</span>  <span class="comment">// If this mock method has an extra matcher (i.e. .With(matcher)),</span></div>
<div class="line"><a id="l01062" name="l01062"></a><span class="lineno"> 1062</span>  <span class="comment">// describes it to the ostream.</span></div>
<div class="line"><a id="l01063" name="l01063"></a><span class="lineno"> 1063</span>  <span class="keywordtype">void</span> MaybeDescribeExtraMatcherTo(::std::ostream* os)<span class="keyword"> override </span>{</div>
<div class="line"><a id="l01064" name="l01064"></a><span class="lineno"> 1064</span>    <span class="keywordflow">if</span> (extra_matcher_specified_) {</div>
<div class="line"><a id="l01065" name="l01065"></a><span class="lineno"> 1065</span>      *os &lt;&lt; <span class="stringliteral">&quot;    Expected args: &quot;</span>;</div>
<div class="line"><a id="l01066" name="l01066"></a><span class="lineno"> 1066</span>      extra_matcher_.DescribeTo(os);</div>
<div class="line"><a id="l01067" name="l01067"></a><span class="lineno"> 1067</span>      *os &lt;&lt; <span class="stringliteral">&quot;\n&quot;</span>;</div>
<div class="line"><a id="l01068" name="l01068"></a><span class="lineno"> 1068</span>    }</div>
<div class="line"><a id="l01069" name="l01069"></a><span class="lineno"> 1069</span>  }</div>
<div class="line"><a id="l01070" name="l01070"></a><span class="lineno"> 1070</span> </div>
<div class="line"><a id="l01071" name="l01071"></a><span class="lineno"> 1071</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01072" name="l01072"></a><span class="lineno"> 1072</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Function&gt;</div>
<div class="line"><a id="l01073" name="l01073"></a><span class="lineno"> 1073</span>  <span class="keyword">friend</span> <span class="keyword">class </span>FunctionMocker;</div>
<div class="line"><a id="l01074" name="l01074"></a><span class="lineno"> 1074</span> </div>
<div class="line"><a id="l01075" name="l01075"></a><span class="lineno"> 1075</span>  <span class="comment">// An adaptor that turns a OneAction&lt;F&gt; into something compatible with</span></div>
<div class="line"><a id="l01076" name="l01076"></a><span class="lineno"> 1076</span>  <span class="comment">// Action&lt;F&gt;. Must be called at most once.</span></div>
<div class="line"><a id="l01077" name="l01077"></a><span class="lineno"> 1077</span>  <span class="keyword">struct </span>ActionAdaptor {</div>
<div class="line"><a id="l01078" name="l01078"></a><span class="lineno"> 1078</span>    std::shared_ptr&lt;OnceAction&lt;R(Args...)&gt;&gt; once_action;</div>
<div class="line"><a id="l01079" name="l01079"></a><span class="lineno"> 1079</span> </div>
<div class="line"><a id="l01080" name="l01080"></a><span class="lineno"> 1080</span>    R operator()(Args&amp;&amp;... args)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l01081" name="l01081"></a><span class="lineno"> 1081</span>      <span class="keywordflow">return</span> std::move(*once_action).Call(std::forward&lt;Args&gt;(args)...);</div>
<div class="line"><a id="l01082" name="l01082"></a><span class="lineno"> 1082</span>    }</div>
<div class="line"><a id="l01083" name="l01083"></a><span class="lineno"> 1083</span>  };</div>
<div class="line"><a id="l01084" name="l01084"></a><span class="lineno"> 1084</span> </div>
<div class="line"><a id="l01085" name="l01085"></a><span class="lineno"> 1085</span>  <span class="comment">// Returns an Expectation object that references and co-owns this</span></div>
<div class="line"><a id="l01086" name="l01086"></a><span class="lineno"> 1086</span>  <span class="comment">// expectation.</span></div>
<div class="line"><a id="l01087" name="l01087"></a><span class="lineno"> 1087</span>  Expectation GetHandle()<span class="keyword"> override </span>{ <span class="keywordflow">return</span> owner_-&gt;GetHandleOf(<span class="keyword">this</span>); }</div>
<div class="line"><a id="l01088" name="l01088"></a><span class="lineno"> 1088</span> </div>
<div class="line"><a id="l01089" name="l01089"></a><span class="lineno"> 1089</span>  <span class="comment">// The following methods will be called only after the EXPECT_CALL()</span></div>
<div class="line"><a id="l01090" name="l01090"></a><span class="lineno"> 1090</span>  <span class="comment">// statement finishes and when the current thread holds</span></div>
<div class="line"><a id="l01091" name="l01091"></a><span class="lineno"> 1091</span>  <span class="comment">// g_gmock_mutex.</span></div>
<div class="line"><a id="l01092" name="l01092"></a><span class="lineno"> 1092</span> </div>
<div class="line"><a id="l01093" name="l01093"></a><span class="lineno"> 1093</span>  <span class="comment">// Returns true if and only if this expectation matches the given arguments.</span></div>
<div class="line"><a id="l01094" name="l01094"></a><span class="lineno"> 1094</span>  <span class="keywordtype">bool</span> Matches(<span class="keyword">const</span> ArgumentTuple&amp; args) <span class="keyword">const</span></div>
<div class="line"><a id="l01095" name="l01095"></a><span class="lineno"> 1095</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01096" name="l01096"></a><span class="lineno"> 1096</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l01097" name="l01097"></a><span class="lineno"> 1097</span>    <span class="keywordflow">return</span> TupleMatches(matchers_, args) &amp;&amp; extra_matcher_.Matches(args);</div>
<div class="line"><a id="l01098" name="l01098"></a><span class="lineno"> 1098</span>  }</div>
<div class="line"><a id="l01099" name="l01099"></a><span class="lineno"> 1099</span> </div>
<div class="line"><a id="l01100" name="l01100"></a><span class="lineno"> 1100</span>  <span class="comment">// Returns true if and only if this expectation should handle the given</span></div>
<div class="line"><a id="l01101" name="l01101"></a><span class="lineno"> 1101</span>  <span class="comment">// arguments.</span></div>
<div class="line"><a id="l01102" name="l01102"></a><span class="lineno"> 1102</span>  <span class="keywordtype">bool</span> ShouldHandleArguments(<span class="keyword">const</span> ArgumentTuple&amp; args) <span class="keyword">const</span></div>
<div class="line"><a id="l01103" name="l01103"></a><span class="lineno"> 1103</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01104" name="l01104"></a><span class="lineno"> 1104</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l01105" name="l01105"></a><span class="lineno"> 1105</span> </div>
<div class="line"><a id="l01106" name="l01106"></a><span class="lineno"> 1106</span>    <span class="comment">// In case the action count wasn&#39;t checked when the expectation</span></div>
<div class="line"><a id="l01107" name="l01107"></a><span class="lineno"> 1107</span>    <span class="comment">// was defined (e.g. if this expectation has no WillRepeatedly()</span></div>
<div class="line"><a id="l01108" name="l01108"></a><span class="lineno"> 1108</span>    <span class="comment">// or RetiresOnSaturation() clause), we check it when the</span></div>
<div class="line"><a id="l01109" name="l01109"></a><span class="lineno"> 1109</span>    <span class="comment">// expectation is used for the first time.</span></div>
<div class="line"><a id="l01110" name="l01110"></a><span class="lineno"> 1110</span>    CheckActionCountIfNotDone();</div>
<div class="line"><a id="l01111" name="l01111"></a><span class="lineno"> 1111</span>    <span class="keywordflow">return</span> !is_retired() &amp;&amp; AllPrerequisitesAreSatisfied() &amp;&amp; Matches(args);</div>
<div class="line"><a id="l01112" name="l01112"></a><span class="lineno"> 1112</span>  }</div>
<div class="line"><a id="l01113" name="l01113"></a><span class="lineno"> 1113</span> </div>
<div class="line"><a id="l01114" name="l01114"></a><span class="lineno"> 1114</span>  <span class="comment">// Describes the result of matching the arguments against this</span></div>
<div class="line"><a id="l01115" name="l01115"></a><span class="lineno"> 1115</span>  <span class="comment">// expectation to the given ostream.</span></div>
<div class="line"><a id="l01116" name="l01116"></a><span class="lineno"> 1116</span>  <span class="keywordtype">void</span> ExplainMatchResultTo(<span class="keyword">const</span> ArgumentTuple&amp; args, ::std::ostream* os) <span class="keyword">const</span></div>
<div class="line"><a id="l01117" name="l01117"></a><span class="lineno"> 1117</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01118" name="l01118"></a><span class="lineno"> 1118</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l01119" name="l01119"></a><span class="lineno"> 1119</span> </div>
<div class="line"><a id="l01120" name="l01120"></a><span class="lineno"> 1120</span>    <span class="keywordflow">if</span> (is_retired()) {</div>
<div class="line"><a id="l01121" name="l01121"></a><span class="lineno"> 1121</span>      *os &lt;&lt; <span class="stringliteral">&quot;         Expected: the expectation is active\n&quot;</span></div>
<div class="line"><a id="l01122" name="l01122"></a><span class="lineno"> 1122</span>          &lt;&lt; <span class="stringliteral">&quot;           Actual: it is retired\n&quot;</span>;</div>
<div class="line"><a id="l01123" name="l01123"></a><span class="lineno"> 1123</span>    } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!Matches(args)) {</div>
<div class="line"><a id="l01124" name="l01124"></a><span class="lineno"> 1124</span>      <span class="keywordflow">if</span> (!TupleMatches(matchers_, args)) {</div>
<div class="line"><a id="l01125" name="l01125"></a><span class="lineno"> 1125</span>        ExplainMatchFailureTupleTo(matchers_, args, os);</div>
<div class="line"><a id="l01126" name="l01126"></a><span class="lineno"> 1126</span>      }</div>
<div class="line"><a id="l01127" name="l01127"></a><span class="lineno"> 1127</span>      StringMatchResultListener listener;</div>
<div class="line"><a id="l01128" name="l01128"></a><span class="lineno"> 1128</span>      <span class="keywordflow">if</span> (!extra_matcher_.MatchAndExplain(args, &amp;listener)) {</div>
<div class="line"><a id="l01129" name="l01129"></a><span class="lineno"> 1129</span>        *os &lt;&lt; <span class="stringliteral">&quot;    Expected args: &quot;</span>;</div>
<div class="line"><a id="l01130" name="l01130"></a><span class="lineno"> 1130</span>        extra_matcher_.DescribeTo(os);</div>
<div class="line"><a id="l01131" name="l01131"></a><span class="lineno"> 1131</span>        *os &lt;&lt; <span class="stringliteral">&quot;\n           Actual: don&#39;t match&quot;</span>;</div>
<div class="line"><a id="l01132" name="l01132"></a><span class="lineno"> 1132</span> </div>
<div class="line"><a id="l01133" name="l01133"></a><span class="lineno"> 1133</span>        internal::PrintIfNotEmpty(listener.str(), os);</div>
<div class="line"><a id="l01134" name="l01134"></a><span class="lineno"> 1134</span>        *os &lt;&lt; <span class="stringliteral">&quot;\n&quot;</span>;</div>
<div class="line"><a id="l01135" name="l01135"></a><span class="lineno"> 1135</span>      }</div>
<div class="line"><a id="l01136" name="l01136"></a><span class="lineno"> 1136</span>    } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!AllPrerequisitesAreSatisfied()) {</div>
<div class="line"><a id="l01137" name="l01137"></a><span class="lineno"> 1137</span>      *os &lt;&lt; <span class="stringliteral">&quot;         Expected: all pre-requisites are satisfied\n&quot;</span></div>
<div class="line"><a id="l01138" name="l01138"></a><span class="lineno"> 1138</span>          &lt;&lt; <span class="stringliteral">&quot;           Actual: the following immediate pre-requisites &quot;</span></div>
<div class="line"><a id="l01139" name="l01139"></a><span class="lineno"> 1139</span>          &lt;&lt; <span class="stringliteral">&quot;are not satisfied:\n&quot;</span>;</div>
<div class="line"><a id="l01140" name="l01140"></a><span class="lineno"> 1140</span>      ExpectationSet unsatisfied_prereqs;</div>
<div class="line"><a id="l01141" name="l01141"></a><span class="lineno"> 1141</span>      FindUnsatisfiedPrerequisites(&amp;unsatisfied_prereqs);</div>
<div class="line"><a id="l01142" name="l01142"></a><span class="lineno"> 1142</span>      <span class="keywordtype">int</span> i = 0;</div>
<div class="line"><a id="l01143" name="l01143"></a><span class="lineno"> 1143</span>      <span class="keywordflow">for</span> (ExpectationSet::const_iterator it = unsatisfied_prereqs.begin();</div>
<div class="line"><a id="l01144" name="l01144"></a><span class="lineno"> 1144</span>           it != unsatisfied_prereqs.end(); ++it) {</div>
<div class="line"><a id="l01145" name="l01145"></a><span class="lineno"> 1145</span>        it-&gt;expectation_base()-&gt;DescribeLocationTo(os);</div>
<div class="line"><a id="l01146" name="l01146"></a><span class="lineno"> 1146</span>        *os &lt;&lt; <span class="stringliteral">&quot;pre-requisite #&quot;</span> &lt;&lt; i++ &lt;&lt; <span class="stringliteral">&quot;\n&quot;</span>;</div>
<div class="line"><a id="l01147" name="l01147"></a><span class="lineno"> 1147</span>      }</div>
<div class="line"><a id="l01148" name="l01148"></a><span class="lineno"> 1148</span>      *os &lt;&lt; <span class="stringliteral">&quot;                   (end of pre-requisites)\n&quot;</span>;</div>
<div class="line"><a id="l01149" name="l01149"></a><span class="lineno"> 1149</span>    } <span class="keywordflow">else</span> {</div>
<div class="line"><a id="l01150" name="l01150"></a><span class="lineno"> 1150</span>      <span class="comment">// This line is here just for completeness&#39; sake.  It will never</span></div>
<div class="line"><a id="l01151" name="l01151"></a><span class="lineno"> 1151</span>      <span class="comment">// be executed as currently the ExplainMatchResultTo() function</span></div>
<div class="line"><a id="l01152" name="l01152"></a><span class="lineno"> 1152</span>      <span class="comment">// is called only when the mock function call does NOT match the</span></div>
<div class="line"><a id="l01153" name="l01153"></a><span class="lineno"> 1153</span>      <span class="comment">// expectation.</span></div>
<div class="line"><a id="l01154" name="l01154"></a><span class="lineno"> 1154</span>      *os &lt;&lt; <span class="stringliteral">&quot;The call matches the expectation.\n&quot;</span>;</div>
<div class="line"><a id="l01155" name="l01155"></a><span class="lineno"> 1155</span>    }</div>
<div class="line"><a id="l01156" name="l01156"></a><span class="lineno"> 1156</span>  }</div>
<div class="line"><a id="l01157" name="l01157"></a><span class="lineno"> 1157</span> </div>
<div class="line"><a id="l01158" name="l01158"></a><span class="lineno"> 1158</span>  <span class="comment">// Returns the action that should be taken for the current invocation.</span></div>
<div class="line"><a id="l01159" name="l01159"></a><span class="lineno"> 1159</span>  <span class="keyword">const</span> Action&lt;F&gt;&amp; GetCurrentAction(<span class="keyword">const</span> FunctionMocker&lt;F&gt;* mocker,</div>
<div class="line"><a id="l01160" name="l01160"></a><span class="lineno"> 1160</span>                                    <span class="keyword">const</span> ArgumentTuple&amp; args) <span class="keyword">const</span></div>
<div class="line"><a id="l01161" name="l01161"></a><span class="lineno"> 1161</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01162" name="l01162"></a><span class="lineno"> 1162</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l01163" name="l01163"></a><span class="lineno"> 1163</span>    <span class="keyword">const</span> <span class="keywordtype">int</span> count = call_count();</div>
<div class="line"><a id="l01164" name="l01164"></a><span class="lineno"> 1164</span>    Assert(count &gt;= 1, __FILE__, __LINE__,</div>
<div class="line"><a id="l01165" name="l01165"></a><span class="lineno"> 1165</span>           <span class="stringliteral">&quot;call_count() is &lt;= 0 when GetCurrentAction() is &quot;</span></div>
<div class="line"><a id="l01166" name="l01166"></a><span class="lineno"> 1166</span>           <span class="stringliteral">&quot;called - this should never happen.&quot;</span>);</div>
<div class="line"><a id="l01167" name="l01167"></a><span class="lineno"> 1167</span> </div>
<div class="line"><a id="l01168" name="l01168"></a><span class="lineno"> 1168</span>    <span class="keyword">const</span> <span class="keywordtype">int</span> action_count = <span class="keyword">static_cast&lt;</span><span class="keywordtype">int</span><span class="keyword">&gt;</span>(untyped_actions_.size());</div>
<div class="line"><a id="l01169" name="l01169"></a><span class="lineno"> 1169</span>    <span class="keywordflow">if</span> (action_count &gt; 0 &amp;&amp; !repeated_action_specified_ &amp;&amp;</div>
<div class="line"><a id="l01170" name="l01170"></a><span class="lineno"> 1170</span>        count &gt; action_count) {</div>
<div class="line"><a id="l01171" name="l01171"></a><span class="lineno"> 1171</span>      <span class="comment">// If there is at least one WillOnce() and no WillRepeatedly(),</span></div>
<div class="line"><a id="l01172" name="l01172"></a><span class="lineno"> 1172</span>      <span class="comment">// we warn the user when the WillOnce() clauses ran out.</span></div>
<div class="line"><a id="l01173" name="l01173"></a><span class="lineno"> 1173</span>      ::std::stringstream ss;</div>
<div class="line"><a id="l01174" name="l01174"></a><span class="lineno"> 1174</span>      DescribeLocationTo(&amp;ss);</div>
<div class="line"><a id="l01175" name="l01175"></a><span class="lineno"> 1175</span>      ss &lt;&lt; <span class="stringliteral">&quot;Actions ran out in &quot;</span> &lt;&lt; source_text() &lt;&lt; <span class="stringliteral">&quot;...\n&quot;</span></div>
<div class="line"><a id="l01176" name="l01176"></a><span class="lineno"> 1176</span>         &lt;&lt; <span class="stringliteral">&quot;Called &quot;</span> &lt;&lt; count &lt;&lt; <span class="stringliteral">&quot; times, but only &quot;</span> &lt;&lt; action_count</div>
<div class="line"><a id="l01177" name="l01177"></a><span class="lineno"> 1177</span>         &lt;&lt; <span class="stringliteral">&quot; WillOnce()&quot;</span> &lt;&lt; (action_count == 1 ? <span class="stringliteral">&quot; is&quot;</span> : <span class="stringliteral">&quot;s are&quot;</span>)</div>
<div class="line"><a id="l01178" name="l01178"></a><span class="lineno"> 1178</span>         &lt;&lt; <span class="stringliteral">&quot; specified - &quot;</span>;</div>
<div class="line"><a id="l01179" name="l01179"></a><span class="lineno"> 1179</span>      mocker-&gt;DescribeDefaultActionTo(args, &amp;ss);</div>
<div class="line"><a id="l01180" name="l01180"></a><span class="lineno"> 1180</span>      Log(kWarning, ss.str(), 1);</div>
<div class="line"><a id="l01181" name="l01181"></a><span class="lineno"> 1181</span>    }</div>
<div class="line"><a id="l01182" name="l01182"></a><span class="lineno"> 1182</span> </div>
<div class="line"><a id="l01183" name="l01183"></a><span class="lineno"> 1183</span>    <span class="keywordflow">return</span> count &lt;= action_count</div>
<div class="line"><a id="l01184" name="l01184"></a><span class="lineno"> 1184</span>               ? *<span class="keyword">static_cast&lt;</span><span class="keyword">const </span>Action&lt;F&gt;*<span class="keyword">&gt;</span>(</div>
<div class="line"><a id="l01185" name="l01185"></a><span class="lineno"> 1185</span>                     untyped_actions_[<span class="keyword">static_cast&lt;</span><span class="keywordtype">size_t</span><span class="keyword">&gt;</span>(count - 1)])</div>
<div class="line"><a id="l01186" name="l01186"></a><span class="lineno"> 1186</span>               : repeated_action();</div>
<div class="line"><a id="l01187" name="l01187"></a><span class="lineno"> 1187</span>  }</div>
<div class="line"><a id="l01188" name="l01188"></a><span class="lineno"> 1188</span> </div>
<div class="line"><a id="l01189" name="l01189"></a><span class="lineno"> 1189</span>  <span class="comment">// Given the arguments of a mock function call, if the call will</span></div>
<div class="line"><a id="l01190" name="l01190"></a><span class="lineno"> 1190</span>  <span class="comment">// over-saturate this expectation, returns the default action;</span></div>
<div class="line"><a id="l01191" name="l01191"></a><span class="lineno"> 1191</span>  <span class="comment">// otherwise, returns the next action in this expectation.  Also</span></div>
<div class="line"><a id="l01192" name="l01192"></a><span class="lineno"> 1192</span>  <span class="comment">// describes *what* happened to &#39;what&#39;, and explains *why* Google</span></div>
<div class="line"><a id="l01193" name="l01193"></a><span class="lineno"> 1193</span>  <span class="comment">// Mock does it to &#39;why&#39;.  This method is not const as it calls</span></div>
<div class="line"><a id="l01194" name="l01194"></a><span class="lineno"> 1194</span>  <span class="comment">// IncrementCallCount().  A return value of NULL means the default</span></div>
<div class="line"><a id="l01195" name="l01195"></a><span class="lineno"> 1195</span>  <span class="comment">// action.</span></div>
<div class="line"><a id="l01196" name="l01196"></a><span class="lineno"> 1196</span>  <span class="keyword">const</span> Action&lt;F&gt;* GetActionForArguments(<span class="keyword">const</span> FunctionMocker&lt;F&gt;* mocker,</div>
<div class="line"><a id="l01197" name="l01197"></a><span class="lineno"> 1197</span>                                         <span class="keyword">const</span> ArgumentTuple&amp; args,</div>
<div class="line"><a id="l01198" name="l01198"></a><span class="lineno"> 1198</span>                                         ::std::ostream* what,</div>
<div class="line"><a id="l01199" name="l01199"></a><span class="lineno"> 1199</span>                                         ::std::ostream* why)</div>
<div class="line"><a id="l01200" name="l01200"></a><span class="lineno"> 1200</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01201" name="l01201"></a><span class="lineno"> 1201</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l01202" name="l01202"></a><span class="lineno"> 1202</span>    <span class="keywordflow">if</span> (IsSaturated()) {</div>
<div class="line"><a id="l01203" name="l01203"></a><span class="lineno"> 1203</span>      <span class="comment">// We have an excessive call.</span></div>
<div class="line"><a id="l01204" name="l01204"></a><span class="lineno"> 1204</span>      IncrementCallCount();</div>
<div class="line"><a id="l01205" name="l01205"></a><span class="lineno"> 1205</span>      *what &lt;&lt; <span class="stringliteral">&quot;Mock function called more times than expected - &quot;</span>;</div>
<div class="line"><a id="l01206" name="l01206"></a><span class="lineno"> 1206</span>      mocker-&gt;DescribeDefaultActionTo(args, what);</div>
<div class="line"><a id="l01207" name="l01207"></a><span class="lineno"> 1207</span>      DescribeCallCountTo(why);</div>
<div class="line"><a id="l01208" name="l01208"></a><span class="lineno"> 1208</span> </div>
<div class="line"><a id="l01209" name="l01209"></a><span class="lineno"> 1209</span>      <span class="keywordflow">return</span> <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l01210" name="l01210"></a><span class="lineno"> 1210</span>    }</div>
<div class="line"><a id="l01211" name="l01211"></a><span class="lineno"> 1211</span> </div>
<div class="line"><a id="l01212" name="l01212"></a><span class="lineno"> 1212</span>    IncrementCallCount();</div>
<div class="line"><a id="l01213" name="l01213"></a><span class="lineno"> 1213</span>    RetireAllPreRequisites();</div>
<div class="line"><a id="l01214" name="l01214"></a><span class="lineno"> 1214</span> </div>
<div class="line"><a id="l01215" name="l01215"></a><span class="lineno"> 1215</span>    <span class="keywordflow">if</span> (retires_on_saturation_ &amp;&amp; IsSaturated()) {</div>
<div class="line"><a id="l01216" name="l01216"></a><span class="lineno"> 1216</span>      Retire();</div>
<div class="line"><a id="l01217" name="l01217"></a><span class="lineno"> 1217</span>    }</div>
<div class="line"><a id="l01218" name="l01218"></a><span class="lineno"> 1218</span> </div>
<div class="line"><a id="l01219" name="l01219"></a><span class="lineno"> 1219</span>    <span class="comment">// Must be done after IncrementCount()!</span></div>
<div class="line"><a id="l01220" name="l01220"></a><span class="lineno"> 1220</span>    *what &lt;&lt; <span class="stringliteral">&quot;Mock function call matches &quot;</span> &lt;&lt; source_text() &lt;&lt; <span class="stringliteral">&quot;...\n&quot;</span>;</div>
<div class="line"><a id="l01221" name="l01221"></a><span class="lineno"> 1221</span>    <span class="keywordflow">return</span> &amp;(GetCurrentAction(mocker, args));</div>
<div class="line"><a id="l01222" name="l01222"></a><span class="lineno"> 1222</span>  }</div>
<div class="line"><a id="l01223" name="l01223"></a><span class="lineno"> 1223</span> </div>
<div class="line"><a id="l01224" name="l01224"></a><span class="lineno"> 1224</span>  <span class="comment">// All the fields below won&#39;t change once the EXPECT_CALL()</span></div>
<div class="line"><a id="l01225" name="l01225"></a><span class="lineno"> 1225</span>  <span class="comment">// statement finishes.</span></div>
<div class="line"><a id="l01226" name="l01226"></a><span class="lineno"> 1226</span>  FunctionMocker&lt;F&gt;* <span class="keyword">const</span> owner_;</div>
<div class="line"><a id="l01227" name="l01227"></a><span class="lineno"> 1227</span>  ArgumentMatcherTuple matchers_;</div>
<div class="line"><a id="l01228" name="l01228"></a><span class="lineno"> 1228</span>  Matcher&lt;const ArgumentTuple&amp;&gt; extra_matcher_;</div>
<div class="line"><a id="l01229" name="l01229"></a><span class="lineno"> 1229</span>  Action&lt;F&gt; repeated_action_;</div>
<div class="line"><a id="l01230" name="l01230"></a><span class="lineno"> 1230</span> </div>
<div class="line"><a id="l01231" name="l01231"></a><span class="lineno"> 1231</span>  TypedExpectation(<span class="keyword">const</span> TypedExpectation&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01232" name="l01232"></a><span class="lineno"> 1232</span>  TypedExpectation&amp; operator=(<span class="keyword">const</span> TypedExpectation&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01233" name="l01233"></a><span class="lineno"> 1233</span>};  <span class="comment">// class TypedExpectation</span></div>
<div class="line"><a id="l01234" name="l01234"></a><span class="lineno"> 1234</span> </div>
<div class="line"><a id="l01235" name="l01235"></a><span class="lineno"> 1235</span><span class="comment">// A MockSpec object is used by ON_CALL() or EXPECT_CALL() for</span></div>
<div class="line"><a id="l01236" name="l01236"></a><span class="lineno"> 1236</span><span class="comment">// specifying the default behavior of, or expectation on, a mock</span></div>
<div class="line"><a id="l01237" name="l01237"></a><span class="lineno"> 1237</span><span class="comment">// function.</span></div>
<div class="line"><a id="l01238" name="l01238"></a><span class="lineno"> 1238</span> </div>
<div class="line"><a id="l01239" name="l01239"></a><span class="lineno"> 1239</span><span class="comment">// Note: class MockSpec really belongs to the ::testing namespace.</span></div>
<div class="line"><a id="l01240" name="l01240"></a><span class="lineno"> 1240</span><span class="comment">// However if we define it in ::testing, MSVC will complain when</span></div>
<div class="line"><a id="l01241" name="l01241"></a><span class="lineno"> 1241</span><span class="comment">// classes in ::testing::internal declare it as a friend class</span></div>
<div class="line"><a id="l01242" name="l01242"></a><span class="lineno"> 1242</span><span class="comment">// template.  To workaround this compiler bug, we define MockSpec in</span></div>
<div class="line"><a id="l01243" name="l01243"></a><span class="lineno"> 1243</span><span class="comment">// ::testing::internal and import it into ::testing.</span></div>
<div class="line"><a id="l01244" name="l01244"></a><span class="lineno"> 1244</span> </div>
<div class="line"><a id="l01245" name="l01245"></a><span class="lineno"> 1245</span><span class="comment">// Logs a message including file and line number information.</span></div>
<div class="line"><a id="l01246" name="l01246"></a><span class="lineno"> 1246</span>GTEST_API_ <span class="keywordtype">void</span> LogWithLocation(testing::internal::LogSeverity severity,</div>
<div class="line"><a id="l01247" name="l01247"></a><span class="lineno"> 1247</span>                                <span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line,</div>
<div class="line"><a id="l01248" name="l01248"></a><span class="lineno"> 1248</span>                                <span class="keyword">const</span> std::string&amp; message);</div>
<div class="line"><a id="l01249" name="l01249"></a><span class="lineno"> 1249</span> </div>
<div class="line"><a id="l01250" name="l01250"></a><span class="lineno"> 1250</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l01251" name="l01251"></a><span class="lineno"> 1251</span><span class="keyword">class </span>MockSpec {</div>
<div class="line"><a id="l01252" name="l01252"></a><span class="lineno"> 1252</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01253" name="l01253"></a><span class="lineno"> 1253</span>  <span class="keyword">typedef</span> <span class="keyword">typename</span> internal::Function&lt;F&gt;::ArgumentTuple ArgumentTuple;</div>
<div class="line"><a id="l01254" name="l01254"></a><span class="lineno"> 1254</span>  <span class="keyword">typedef</span></div>
<div class="line"><a id="l01255" name="l01255"></a><span class="lineno"> 1255</span>      <span class="keyword">typename</span> internal::Function&lt;F&gt;::ArgumentMatcherTuple ArgumentMatcherTuple;</div>
<div class="line"><a id="l01256" name="l01256"></a><span class="lineno"> 1256</span> </div>
<div class="line"><a id="l01257" name="l01257"></a><span class="lineno"> 1257</span>  <span class="comment">// Constructs a MockSpec object, given the function mocker object</span></div>
<div class="line"><a id="l01258" name="l01258"></a><span class="lineno"> 1258</span>  <span class="comment">// that the spec is associated with.</span></div>
<div class="line"><a id="l01259" name="l01259"></a><span class="lineno"> 1259</span>  MockSpec(internal::FunctionMocker&lt;F&gt;* function_mocker,</div>
<div class="line"><a id="l01260" name="l01260"></a><span class="lineno"> 1260</span>           <span class="keyword">const</span> ArgumentMatcherTuple&amp; matchers)</div>
<div class="line"><a id="l01261" name="l01261"></a><span class="lineno"> 1261</span>      : function_mocker_(function_mocker), matchers_(matchers) {}</div>
<div class="line"><a id="l01262" name="l01262"></a><span class="lineno"> 1262</span> </div>
<div class="line"><a id="l01263" name="l01263"></a><span class="lineno"> 1263</span>  <span class="comment">// Adds a new default action spec to the function mocker and returns</span></div>
<div class="line"><a id="l01264" name="l01264"></a><span class="lineno"> 1264</span>  <span class="comment">// the newly created spec.</span></div>
<div class="line"><a id="l01265" name="l01265"></a><span class="lineno"> 1265</span>  internal::OnCallSpec&lt;F&gt;&amp; InternalDefaultActionSetAt(<span class="keyword">const</span> <span class="keywordtype">char</span>* file,</div>
<div class="line"><a id="l01266" name="l01266"></a><span class="lineno"> 1266</span>                                                      <span class="keywordtype">int</span> line, <span class="keyword">const</span> <span class="keywordtype">char</span>* obj,</div>
<div class="line"><a id="l01267" name="l01267"></a><span class="lineno"> 1267</span>                                                      <span class="keyword">const</span> <span class="keywordtype">char</span>* call) {</div>
<div class="line"><a id="l01268" name="l01268"></a><span class="lineno"> 1268</span>    LogWithLocation(internal::kInfo, file, line,</div>
<div class="line"><a id="l01269" name="l01269"></a><span class="lineno"> 1269</span>                    std::string(<span class="stringliteral">&quot;ON_CALL(&quot;</span>) + obj + <span class="stringliteral">&quot;, &quot;</span> + call + <span class="stringliteral">&quot;) invoked&quot;</span>);</div>
<div class="line"><a id="l01270" name="l01270"></a><span class="lineno"> 1270</span>    <span class="keywordflow">return</span> function_mocker_-&gt;AddNewOnCallSpec(file, line, matchers_);</div>
<div class="line"><a id="l01271" name="l01271"></a><span class="lineno"> 1271</span>  }</div>
<div class="line"><a id="l01272" name="l01272"></a><span class="lineno"> 1272</span> </div>
<div class="line"><a id="l01273" name="l01273"></a><span class="lineno"> 1273</span>  <span class="comment">// Adds a new expectation spec to the function mocker and returns</span></div>
<div class="line"><a id="l01274" name="l01274"></a><span class="lineno"> 1274</span>  <span class="comment">// the newly created spec.</span></div>
<div class="line"><a id="l01275" name="l01275"></a><span class="lineno"> 1275</span>  internal::TypedExpectation&lt;F&gt;&amp; InternalExpectedAt(<span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line,</div>
<div class="line"><a id="l01276" name="l01276"></a><span class="lineno"> 1276</span>                                                    <span class="keyword">const</span> <span class="keywordtype">char</span>* obj,</div>
<div class="line"><a id="l01277" name="l01277"></a><span class="lineno"> 1277</span>                                                    <span class="keyword">const</span> <span class="keywordtype">char</span>* call) {</div>
<div class="line"><a id="l01278" name="l01278"></a><span class="lineno"> 1278</span>    <span class="keyword">const</span> std::string source_text(std::string(<span class="stringliteral">&quot;EXPECT_CALL(&quot;</span>) + obj + <span class="stringliteral">&quot;, &quot;</span> +</div>
<div class="line"><a id="l01279" name="l01279"></a><span class="lineno"> 1279</span>                                  call + <span class="stringliteral">&quot;)&quot;</span>);</div>
<div class="line"><a id="l01280" name="l01280"></a><span class="lineno"> 1280</span>    LogWithLocation(internal::kInfo, file, line, source_text + <span class="stringliteral">&quot; invoked&quot;</span>);</div>
<div class="line"><a id="l01281" name="l01281"></a><span class="lineno"> 1281</span>    <span class="keywordflow">return</span> function_mocker_-&gt;AddNewExpectation(file, line, source_text,</div>
<div class="line"><a id="l01282" name="l01282"></a><span class="lineno"> 1282</span>                                               matchers_);</div>
<div class="line"><a id="l01283" name="l01283"></a><span class="lineno"> 1283</span>  }</div>
<div class="line"><a id="l01284" name="l01284"></a><span class="lineno"> 1284</span> </div>
<div class="line"><a id="l01285" name="l01285"></a><span class="lineno"> 1285</span>  <span class="comment">// This operator overload is used to swallow the superfluous parameter list</span></div>
<div class="line"><a id="l01286" name="l01286"></a><span class="lineno"> 1286</span>  <span class="comment">// introduced by the ON/EXPECT_CALL macros. See the macro comments for more</span></div>
<div class="line"><a id="l01287" name="l01287"></a><span class="lineno"> 1287</span>  <span class="comment">// explanation.</span></div>
<div class="line"><a id="l01288" name="l01288"></a><span class="lineno"> 1288</span>  MockSpec&lt;F&gt;&amp; operator()(<span class="keyword">const</span> internal::WithoutMatchers&amp;, <span class="keywordtype">void</span>* <span class="keyword">const</span>) {</div>
<div class="line"><a id="l01289" name="l01289"></a><span class="lineno"> 1289</span>    <span class="keywordflow">return</span> *<span class="keyword">this</span>;</div>
<div class="line"><a id="l01290" name="l01290"></a><span class="lineno"> 1290</span>  }</div>
<div class="line"><a id="l01291" name="l01291"></a><span class="lineno"> 1291</span> </div>
<div class="line"><a id="l01292" name="l01292"></a><span class="lineno"> 1292</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01293" name="l01293"></a><span class="lineno"> 1293</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Function&gt;</div>
<div class="line"><a id="l01294" name="l01294"></a><span class="lineno"> 1294</span>  <span class="keyword">friend</span> <span class="keyword">class </span>internal::FunctionMocker;</div>
<div class="line"><a id="l01295" name="l01295"></a><span class="lineno"> 1295</span> </div>
<div class="line"><a id="l01296" name="l01296"></a><span class="lineno"> 1296</span>  <span class="comment">// The function mocker that owns this spec.</span></div>
<div class="line"><a id="l01297" name="l01297"></a><span class="lineno"> 1297</span>  internal::FunctionMocker&lt;F&gt;* <span class="keyword">const</span> function_mocker_;</div>
<div class="line"><a id="l01298" name="l01298"></a><span class="lineno"> 1298</span>  <span class="comment">// The argument matchers specified in the spec.</span></div>
<div class="line"><a id="l01299" name="l01299"></a><span class="lineno"> 1299</span>  ArgumentMatcherTuple matchers_;</div>
<div class="line"><a id="l01300" name="l01300"></a><span class="lineno"> 1300</span>};  <span class="comment">// class MockSpec</span></div>
<div class="line"><a id="l01301" name="l01301"></a><span class="lineno"> 1301</span> </div>
<div class="line"><a id="l01302" name="l01302"></a><span class="lineno"> 1302</span><span class="comment">// Wrapper type for generically holding an ordinary value or lvalue reference.</span></div>
<div class="line"><a id="l01303" name="l01303"></a><span class="lineno"> 1303</span><span class="comment">// If T is not a reference type, it must be copyable or movable.</span></div>
<div class="line"><a id="l01304" name="l01304"></a><span class="lineno"> 1304</span><span class="comment">// ReferenceOrValueWrapper&lt;T&gt; is movable, and will also be copyable unless</span></div>
<div class="line"><a id="l01305" name="l01305"></a><span class="lineno"> 1305</span><span class="comment">// T is a move-only value type (which means that it will always be copyable</span></div>
<div class="line"><a id="l01306" name="l01306"></a><span class="lineno"> 1306</span><span class="comment">// if the current platform does not support move semantics).</span></div>
<div class="line"><a id="l01307" name="l01307"></a><span class="lineno"> 1307</span><span class="comment">//</span></div>
<div class="line"><a id="l01308" name="l01308"></a><span class="lineno"> 1308</span><span class="comment">// The primary template defines handling for values, but function header</span></div>
<div class="line"><a id="l01309" name="l01309"></a><span class="lineno"> 1309</span><span class="comment">// comments describe the contract for the whole template (including</span></div>
<div class="line"><a id="l01310" name="l01310"></a><span class="lineno"> 1310</span><span class="comment">// specializations).</span></div>
<div class="line"><a id="l01311" name="l01311"></a><span class="lineno"> 1311</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="line"><a id="l01312" name="l01312"></a><span class="lineno"> 1312</span><span class="keyword">class </span>ReferenceOrValueWrapper {</div>
<div class="line"><a id="l01313" name="l01313"></a><span class="lineno"> 1313</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01314" name="l01314"></a><span class="lineno"> 1314</span>  <span class="comment">// Constructs a wrapper from the given value/reference.</span></div>
<div class="line"><a id="l01315" name="l01315"></a><span class="lineno"> 1315</span>  <span class="keyword">explicit</span> ReferenceOrValueWrapper(T value) : value_(std::move(value)) {}</div>
<div class="line"><a id="l01316" name="l01316"></a><span class="lineno"> 1316</span> </div>
<div class="line"><a id="l01317" name="l01317"></a><span class="lineno"> 1317</span>  <span class="comment">// Unwraps and returns the underlying value/reference, exactly as</span></div>
<div class="line"><a id="l01318" name="l01318"></a><span class="lineno"> 1318</span>  <span class="comment">// originally passed. The behavior of calling this more than once on</span></div>
<div class="line"><a id="l01319" name="l01319"></a><span class="lineno"> 1319</span>  <span class="comment">// the same object is unspecified.</span></div>
<div class="line"><a id="l01320" name="l01320"></a><span class="lineno"> 1320</span>  T Unwrap() { <span class="keywordflow">return</span> std::move(value_); }</div>
<div class="line"><a id="l01321" name="l01321"></a><span class="lineno"> 1321</span> </div>
<div class="line"><a id="l01322" name="l01322"></a><span class="lineno"> 1322</span>  <span class="comment">// Provides nondestructive access to the underlying value/reference.</span></div>
<div class="line"><a id="l01323" name="l01323"></a><span class="lineno"> 1323</span>  <span class="comment">// Always returns a const reference (more precisely,</span></div>
<div class="line"><a id="l01324" name="l01324"></a><span class="lineno"> 1324</span>  <span class="comment">// const std::add_lvalue_reference&lt;T&gt;::type). The behavior of calling this</span></div>
<div class="line"><a id="l01325" name="l01325"></a><span class="lineno"> 1325</span>  <span class="comment">// after calling Unwrap on the same object is unspecified.</span></div>
<div class="line"><a id="l01326" name="l01326"></a><span class="lineno"> 1326</span>  <span class="keyword">const</span> T&amp; Peek()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> value_; }</div>
<div class="line"><a id="l01327" name="l01327"></a><span class="lineno"> 1327</span> </div>
<div class="line"><a id="l01328" name="l01328"></a><span class="lineno"> 1328</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01329" name="l01329"></a><span class="lineno"> 1329</span>  T value_;</div>
<div class="line"><a id="l01330" name="l01330"></a><span class="lineno"> 1330</span>};</div>
<div class="line"><a id="l01331" name="l01331"></a><span class="lineno"> 1331</span> </div>
<div class="line"><a id="l01332" name="l01332"></a><span class="lineno"> 1332</span><span class="comment">// Specialization for lvalue reference types. See primary template</span></div>
<div class="line"><a id="l01333" name="l01333"></a><span class="lineno"> 1333</span><span class="comment">// for documentation.</span></div>
<div class="line"><a id="l01334" name="l01334"></a><span class="lineno"> 1334</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="line"><a id="l01335" name="l01335"></a><span class="lineno"> 1335</span><span class="keyword">class </span>ReferenceOrValueWrapper&lt;T&amp;&gt; {</div>
<div class="line"><a id="l01336" name="l01336"></a><span class="lineno"> 1336</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01337" name="l01337"></a><span class="lineno"> 1337</span>  <span class="comment">// Workaround for debatable pass-by-reference lint warning (c-library-team</span></div>
<div class="line"><a id="l01338" name="l01338"></a><span class="lineno"> 1338</span>  <span class="comment">// policy precludes NOLINT in this context)</span></div>
<div class="line"><a id="l01339" name="l01339"></a><span class="lineno"> 1339</span>  <span class="keyword">typedef</span> T&amp; reference;</div>
<div class="line"><a id="l01340" name="l01340"></a><span class="lineno"> 1340</span>  <span class="keyword">explicit</span> ReferenceOrValueWrapper(reference ref) : value_ptr_(&amp;ref) {}</div>
<div class="line"><a id="l01341" name="l01341"></a><span class="lineno"> 1341</span>  T&amp; Unwrap() { <span class="keywordflow">return</span> *value_ptr_; }</div>
<div class="line"><a id="l01342" name="l01342"></a><span class="lineno"> 1342</span>  <span class="keyword">const</span> T&amp; Peek()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> *value_ptr_; }</div>
<div class="line"><a id="l01343" name="l01343"></a><span class="lineno"> 1343</span> </div>
<div class="line"><a id="l01344" name="l01344"></a><span class="lineno"> 1344</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01345" name="l01345"></a><span class="lineno"> 1345</span>  T* value_ptr_;</div>
<div class="line"><a id="l01346" name="l01346"></a><span class="lineno"> 1346</span>};</div>
<div class="line"><a id="l01347" name="l01347"></a><span class="lineno"> 1347</span> </div>
<div class="line"><a id="l01348" name="l01348"></a><span class="lineno"> 1348</span><span class="comment">// Prints the held value as an action&#39;s result to os.</span></div>
<div class="line"><a id="l01349" name="l01349"></a><span class="lineno"> 1349</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="line"><a id="l01350" name="l01350"></a><span class="lineno"> 1350</span><span class="keywordtype">void</span> PrintAsActionResult(<span class="keyword">const</span> T&amp; result, std::ostream&amp; os) {</div>
<div class="line"><a id="l01351" name="l01351"></a><span class="lineno"> 1351</span>  os &lt;&lt; <span class="stringliteral">&quot;\n          Returns: &quot;</span>;</div>
<div class="line"><a id="l01352" name="l01352"></a><span class="lineno"> 1352</span>  <span class="comment">// T may be a reference type, so we don&#39;t use UniversalPrint().</span></div>
<div class="line"><a id="l01353" name="l01353"></a><span class="lineno"> 1353</span>  UniversalPrinter&lt;T&gt;::Print(result, &amp;os);</div>
<div class="line"><a id="l01354" name="l01354"></a><span class="lineno"> 1354</span>}</div>
<div class="line"><a id="l01355" name="l01355"></a><span class="lineno"> 1355</span> </div>
<div class="line"><a id="l01356" name="l01356"></a><span class="lineno"> 1356</span><span class="comment">// Reports an uninteresting call (whose description is in msg) in the</span></div>
<div class="line"><a id="l01357" name="l01357"></a><span class="lineno"> 1357</span><span class="comment">// manner specified by &#39;reaction&#39;.</span></div>
<div class="line"><a id="l01358" name="l01358"></a><span class="lineno"> 1358</span>GTEST_API_ <span class="keywordtype">void</span> ReportUninterestingCall(CallReaction reaction,</div>
<div class="line"><a id="l01359" name="l01359"></a><span class="lineno"> 1359</span>                                        <span class="keyword">const</span> std::string&amp; msg);</div>
<div class="line"><a id="l01360" name="l01360"></a><span class="lineno"> 1360</span> </div>
<div class="line"><a id="l01361" name="l01361"></a><span class="lineno"> 1361</span><span class="comment">// A generic RAII type that runs a user-provided function in its destructor.</span></div>
<div class="line"><a id="l01362" name="l01362"></a><span class="lineno"> 1362</span><span class="keyword">class </span>Cleanup final {</div>
<div class="line"><a id="l01363" name="l01363"></a><span class="lineno"> 1363</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01364" name="l01364"></a><span class="lineno"> 1364</span>  <span class="keyword">explicit</span> Cleanup(std::function&lt;<span class="keywordtype">void</span>()&gt; f) : f_(std::move(f)) {}</div>
<div class="line"><a id="l01365" name="l01365"></a><span class="lineno"> 1365</span>  ~Cleanup() { f_(); }</div>
<div class="line"><a id="l01366" name="l01366"></a><span class="lineno"> 1366</span> </div>
<div class="line"><a id="l01367" name="l01367"></a><span class="lineno"> 1367</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01368" name="l01368"></a><span class="lineno"> 1368</span>  std::function&lt;void()&gt; f_;</div>
<div class="line"><a id="l01369" name="l01369"></a><span class="lineno"> 1369</span>};</div>
<div class="line"><a id="l01370" name="l01370"></a><span class="lineno"> 1370</span> </div>
<div class="line"><a id="l01371" name="l01371"></a><span class="lineno"> 1371</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l01372" name="l01372"></a><span class="lineno"> 1372</span><span class="keyword">class </span>FunctionMocker;</div>
<div class="line"><a id="l01373" name="l01373"></a><span class="lineno"> 1373</span> </div>
<div class="line"><a id="l01374" name="l01374"></a><span class="lineno"> 1374</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> R, <span class="keyword">typename</span>... Args&gt;</div>
<div class="line"><a id="l01375" name="l01375"></a><span class="lineno"> 1375</span><span class="keyword">class </span>FunctionMocker&lt;R(Args...)&gt; final : <span class="keyword">public</span> UntypedFunctionMockerBase {</div>
<div class="line"><a id="l01376" name="l01376"></a><span class="lineno"> 1376</span>  <span class="keyword">using </span>F = R(Args...);</div>
<div class="line"><a id="l01377" name="l01377"></a><span class="lineno"> 1377</span> </div>
<div class="line"><a id="l01378" name="l01378"></a><span class="lineno"> 1378</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01379" name="l01379"></a><span class="lineno"> 1379</span>  <span class="keyword">using </span>Result = R;</div>
<div class="line"><a id="l01380" name="l01380"></a><span class="lineno"> 1380</span>  <span class="keyword">using </span>ArgumentTuple = std::tuple&lt;Args...&gt;;</div>
<div class="line"><a id="l01381" name="l01381"></a><span class="lineno"> 1381</span>  <span class="keyword">using </span>ArgumentMatcherTuple = std::tuple&lt;Matcher&lt;Args&gt;...&gt;;</div>
<div class="line"><a id="l01382" name="l01382"></a><span class="lineno"> 1382</span> </div>
<div class="line"><a id="l01383" name="l01383"></a><span class="lineno"> 1383</span>  FunctionMocker() {}</div>
<div class="line"><a id="l01384" name="l01384"></a><span class="lineno"> 1384</span> </div>
<div class="line"><a id="l01385" name="l01385"></a><span class="lineno"> 1385</span>  <span class="comment">// There is no generally useful and implementable semantics of</span></div>
<div class="line"><a id="l01386" name="l01386"></a><span class="lineno"> 1386</span>  <span class="comment">// copying a mock object, so copying a mock is usually a user error.</span></div>
<div class="line"><a id="l01387" name="l01387"></a><span class="lineno"> 1387</span>  <span class="comment">// Thus we disallow copying function mockers.  If the user really</span></div>
<div class="line"><a id="l01388" name="l01388"></a><span class="lineno"> 1388</span>  <span class="comment">// wants to copy a mock object, they should implement their own copy</span></div>
<div class="line"><a id="l01389" name="l01389"></a><span class="lineno"> 1389</span>  <span class="comment">// operation, for example:</span></div>
<div class="line"><a id="l01390" name="l01390"></a><span class="lineno"> 1390</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01391" name="l01391"></a><span class="lineno"> 1391</span>  <span class="comment">//   class MockFoo : public Foo {</span></div>
<div class="line"><a id="l01392" name="l01392"></a><span class="lineno"> 1392</span>  <span class="comment">//    public:</span></div>
<div class="line"><a id="l01393" name="l01393"></a><span class="lineno"> 1393</span>  <span class="comment">//     // Defines a copy constructor explicitly.</span></div>
<div class="line"><a id="l01394" name="l01394"></a><span class="lineno"> 1394</span>  <span class="comment">//     MockFoo(const MockFoo&amp; src) {}</span></div>
<div class="line"><a id="l01395" name="l01395"></a><span class="lineno"> 1395</span>  <span class="comment">//     ...</span></div>
<div class="line"><a id="l01396" name="l01396"></a><span class="lineno"> 1396</span>  <span class="comment">//   };</span></div>
<div class="line"><a id="l01397" name="l01397"></a><span class="lineno"> 1397</span>  FunctionMocker(<span class="keyword">const</span> FunctionMocker&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01398" name="l01398"></a><span class="lineno"> 1398</span>  FunctionMocker&amp; operator=(<span class="keyword">const</span> FunctionMocker&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01399" name="l01399"></a><span class="lineno"> 1399</span> </div>
<div class="line"><a id="l01400" name="l01400"></a><span class="lineno"> 1400</span>  <span class="comment">// The destructor verifies that all expectations on this mock</span></div>
<div class="line"><a id="l01401" name="l01401"></a><span class="lineno"> 1401</span>  <span class="comment">// function have been satisfied.  If not, it will report Google Test</span></div>
<div class="line"><a id="l01402" name="l01402"></a><span class="lineno"> 1402</span>  <span class="comment">// non-fatal failures for the violations.</span></div>
<div class="line"><a id="l01403" name="l01403"></a><span class="lineno"> 1403</span>  ~FunctionMocker() override GTEST_LOCK_EXCLUDED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01404" name="l01404"></a><span class="lineno"> 1404</span>    MutexLock l(&amp;g_gmock_mutex);</div>
<div class="line"><a id="l01405" name="l01405"></a><span class="lineno"> 1405</span>    VerifyAndClearExpectationsLocked();</div>
<div class="line"><a id="l01406" name="l01406"></a><span class="lineno"> 1406</span>    Mock::UnregisterLocked(<span class="keyword">this</span>);</div>
<div class="line"><a id="l01407" name="l01407"></a><span class="lineno"> 1407</span>    ClearDefaultActionsLocked();</div>
<div class="line"><a id="l01408" name="l01408"></a><span class="lineno"> 1408</span>  }</div>
<div class="line"><a id="l01409" name="l01409"></a><span class="lineno"> 1409</span> </div>
<div class="line"><a id="l01410" name="l01410"></a><span class="lineno"> 1410</span>  <span class="comment">// Returns the ON_CALL spec that matches this mock function with the</span></div>
<div class="line"><a id="l01411" name="l01411"></a><span class="lineno"> 1411</span>  <span class="comment">// given arguments; returns NULL if no matching ON_CALL is found.</span></div>
<div class="line"><a id="l01412" name="l01412"></a><span class="lineno"> 1412</span>  <span class="comment">// L = *</span></div>
<div class="line"><a id="l01413" name="l01413"></a><span class="lineno"> 1413</span>  <span class="keyword">const</span> OnCallSpec&lt;F&gt;* FindOnCallSpec(<span class="keyword">const</span> ArgumentTuple&amp; args)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l01414" name="l01414"></a><span class="lineno"> 1414</span>    <span class="keywordflow">for</span> (UntypedOnCallSpecs::const_reverse_iterator it =</div>
<div class="line"><a id="l01415" name="l01415"></a><span class="lineno"> 1415</span>             untyped_on_call_specs_.rbegin();</div>
<div class="line"><a id="l01416" name="l01416"></a><span class="lineno"> 1416</span>         it != untyped_on_call_specs_.rend(); ++it) {</div>
<div class="line"><a id="l01417" name="l01417"></a><span class="lineno"> 1417</span>      <span class="keyword">const</span> OnCallSpec&lt;F&gt;* spec = <span class="keyword">static_cast&lt;</span><span class="keyword">const </span>OnCallSpec&lt;F&gt;*<span class="keyword">&gt;</span>(*it);</div>
<div class="line"><a id="l01418" name="l01418"></a><span class="lineno"> 1418</span>      <span class="keywordflow">if</span> (spec-&gt;Matches(args)) <span class="keywordflow">return</span> spec;</div>
<div class="line"><a id="l01419" name="l01419"></a><span class="lineno"> 1419</span>    }</div>
<div class="line"><a id="l01420" name="l01420"></a><span class="lineno"> 1420</span> </div>
<div class="line"><a id="l01421" name="l01421"></a><span class="lineno"> 1421</span>    <span class="keywordflow">return</span> <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l01422" name="l01422"></a><span class="lineno"> 1422</span>  }</div>
<div class="line"><a id="l01423" name="l01423"></a><span class="lineno"> 1423</span> </div>
<div class="line"><a id="l01424" name="l01424"></a><span class="lineno"> 1424</span>  <span class="comment">// Performs the default action of this mock function on the given</span></div>
<div class="line"><a id="l01425" name="l01425"></a><span class="lineno"> 1425</span>  <span class="comment">// arguments and returns the result. Asserts (or throws if</span></div>
<div class="line"><a id="l01426" name="l01426"></a><span class="lineno"> 1426</span>  <span class="comment">// exceptions are enabled) with a helpful call description if there</span></div>
<div class="line"><a id="l01427" name="l01427"></a><span class="lineno"> 1427</span>  <span class="comment">// is no valid return value. This method doesn&#39;t depend on the</span></div>
<div class="line"><a id="l01428" name="l01428"></a><span class="lineno"> 1428</span>  <span class="comment">// mutable state of this object, and thus can be called concurrently</span></div>
<div class="line"><a id="l01429" name="l01429"></a><span class="lineno"> 1429</span>  <span class="comment">// without locking.</span></div>
<div class="line"><a id="l01430" name="l01430"></a><span class="lineno"> 1430</span>  <span class="comment">// L = *</span></div>
<div class="line"><a id="l01431" name="l01431"></a><span class="lineno"> 1431</span>  Result PerformDefaultAction(ArgumentTuple&amp;&amp; args,</div>
<div class="line"><a id="l01432" name="l01432"></a><span class="lineno"> 1432</span>                              <span class="keyword">const</span> std::string&amp; call_description)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l01433" name="l01433"></a><span class="lineno"> 1433</span>    <span class="keyword">const</span> OnCallSpec&lt;F&gt;* <span class="keyword">const</span> spec = this-&gt;FindOnCallSpec(args);</div>
<div class="line"><a id="l01434" name="l01434"></a><span class="lineno"> 1434</span>    <span class="keywordflow">if</span> (spec != <span class="keyword">nullptr</span>) {</div>
<div class="line"><a id="l01435" name="l01435"></a><span class="lineno"> 1435</span>      <span class="keywordflow">return</span> spec-&gt;GetAction().Perform(std::move(args));</div>
<div class="line"><a id="l01436" name="l01436"></a><span class="lineno"> 1436</span>    }</div>
<div class="line"><a id="l01437" name="l01437"></a><span class="lineno"> 1437</span>    <span class="keyword">const</span> std::string message =</div>
<div class="line"><a id="l01438" name="l01438"></a><span class="lineno"> 1438</span>        call_description +</div>
<div class="line"><a id="l01439" name="l01439"></a><span class="lineno"> 1439</span>        <span class="stringliteral">&quot;\n    The mock function has no default action &quot;</span></div>
<div class="line"><a id="l01440" name="l01440"></a><span class="lineno"> 1440</span>        <span class="stringliteral">&quot;set, and its return type has no default value set.&quot;</span>;</div>
<div class="line"><a id="l01441" name="l01441"></a><span class="lineno"> 1441</span><span class="preprocessor">#if GTEST_HAS_EXCEPTIONS</span></div>
<div class="line"><a id="l01442" name="l01442"></a><span class="lineno"> 1442</span>    <span class="keywordflow">if</span> (!DefaultValue&lt;Result&gt;::Exists()) {</div>
<div class="line"><a id="l01443" name="l01443"></a><span class="lineno"> 1443</span>      <span class="keywordflow">throw</span> std::runtime_error(message);</div>
<div class="line"><a id="l01444" name="l01444"></a><span class="lineno"> 1444</span>    }</div>
<div class="line"><a id="l01445" name="l01445"></a><span class="lineno"> 1445</span><span class="preprocessor">#else</span></div>
<div class="line"><a id="l01446" name="l01446"></a><span class="lineno"> 1446</span>    Assert(DefaultValue&lt;Result&gt;::Exists(), <span class="stringliteral">&quot;&quot;</span>, -1, message);</div>
<div class="line"><a id="l01447" name="l01447"></a><span class="lineno"> 1447</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l01448" name="l01448"></a><span class="lineno"> 1448</span>    <span class="keywordflow">return</span> DefaultValue&lt;Result&gt;::Get();</div>
<div class="line"><a id="l01449" name="l01449"></a><span class="lineno"> 1449</span>  }</div>
<div class="line"><a id="l01450" name="l01450"></a><span class="lineno"> 1450</span> </div>
<div class="line"><a id="l01451" name="l01451"></a><span class="lineno"> 1451</span>  <span class="comment">// Implements UntypedFunctionMockerBase::ClearDefaultActionsLocked():</span></div>
<div class="line"><a id="l01452" name="l01452"></a><span class="lineno"> 1452</span>  <span class="comment">// clears the ON_CALL()s set on this mock function.</span></div>
<div class="line"><a id="l01453" name="l01453"></a><span class="lineno"> 1453</span>  <span class="keywordtype">void</span> ClearDefaultActionsLocked() override</div>
<div class="line"><a id="l01454" name="l01454"></a><span class="lineno"> 1454</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01455" name="l01455"></a><span class="lineno"> 1455</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l01456" name="l01456"></a><span class="lineno"> 1456</span> </div>
<div class="line"><a id="l01457" name="l01457"></a><span class="lineno"> 1457</span>    <span class="comment">// Deleting our default actions may trigger other mock objects to be</span></div>
<div class="line"><a id="l01458" name="l01458"></a><span class="lineno"> 1458</span>    <span class="comment">// deleted, for example if an action contains a reference counted smart</span></div>
<div class="line"><a id="l01459" name="l01459"></a><span class="lineno"> 1459</span>    <span class="comment">// pointer to that mock object, and that is the last reference. So if we</span></div>
<div class="line"><a id="l01460" name="l01460"></a><span class="lineno"> 1460</span>    <span class="comment">// delete our actions within the context of the global mutex we may deadlock</span></div>
<div class="line"><a id="l01461" name="l01461"></a><span class="lineno"> 1461</span>    <span class="comment">// when this method is called again. Instead, make a copy of the set of</span></div>
<div class="line"><a id="l01462" name="l01462"></a><span class="lineno"> 1462</span>    <span class="comment">// actions to delete, clear our set within the mutex, and then delete the</span></div>
<div class="line"><a id="l01463" name="l01463"></a><span class="lineno"> 1463</span>    <span class="comment">// actions outside of the mutex.</span></div>
<div class="line"><a id="l01464" name="l01464"></a><span class="lineno"> 1464</span>    UntypedOnCallSpecs specs_to_delete;</div>
<div class="line"><a id="l01465" name="l01465"></a><span class="lineno"> 1465</span>    untyped_on_call_specs_.swap(specs_to_delete);</div>
<div class="line"><a id="l01466" name="l01466"></a><span class="lineno"> 1466</span> </div>
<div class="line"><a id="l01467" name="l01467"></a><span class="lineno"> 1467</span>    g_gmock_mutex.Unlock();</div>
<div class="line"><a id="l01468" name="l01468"></a><span class="lineno"> 1468</span>    <span class="keywordflow">for</span> (UntypedOnCallSpecs::const_iterator it = specs_to_delete.begin();</div>
<div class="line"><a id="l01469" name="l01469"></a><span class="lineno"> 1469</span>         it != specs_to_delete.end(); ++it) {</div>
<div class="line"><a id="l01470" name="l01470"></a><span class="lineno"> 1470</span>      delete static_cast&lt;const OnCallSpec&lt;F&gt;*&gt;(*it);</div>
<div class="line"><a id="l01471" name="l01471"></a><span class="lineno"> 1471</span>    }</div>
<div class="line"><a id="l01472" name="l01472"></a><span class="lineno"> 1472</span> </div>
<div class="line"><a id="l01473" name="l01473"></a><span class="lineno"> 1473</span>    <span class="comment">// Lock the mutex again, since the caller expects it to be locked when we</span></div>
<div class="line"><a id="l01474" name="l01474"></a><span class="lineno"> 1474</span>    <span class="comment">// return.</span></div>
<div class="line"><a id="l01475" name="l01475"></a><span class="lineno"> 1475</span>    g_gmock_mutex.Lock();</div>
<div class="line"><a id="l01476" name="l01476"></a><span class="lineno"> 1476</span>  }</div>
<div class="line"><a id="l01477" name="l01477"></a><span class="lineno"> 1477</span> </div>
<div class="line"><a id="l01478" name="l01478"></a><span class="lineno"> 1478</span>  <span class="comment">// Returns the result of invoking this mock function with the given</span></div>
<div class="line"><a id="l01479" name="l01479"></a><span class="lineno"> 1479</span>  <span class="comment">// arguments.  This function can be safely called from multiple</span></div>
<div class="line"><a id="l01480" name="l01480"></a><span class="lineno"> 1480</span>  <span class="comment">// threads concurrently.</span></div>
<div class="line"><a id="l01481" name="l01481"></a><span class="lineno"> 1481</span>  Result Invoke(Args... args) GTEST_LOCK_EXCLUDED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01482" name="l01482"></a><span class="lineno"> 1482</span>    <span class="keywordflow">return</span> InvokeWith(ArgumentTuple(std::forward&lt;Args&gt;(args)...));</div>
<div class="line"><a id="l01483" name="l01483"></a><span class="lineno"> 1483</span>  }</div>
<div class="line"><a id="l01484" name="l01484"></a><span class="lineno"> 1484</span> </div>
<div class="line"><a id="l01485" name="l01485"></a><span class="lineno"> 1485</span>  MockSpec&lt;F&gt; With(Matcher&lt;Args&gt;... m) {</div>
<div class="line"><a id="l01486" name="l01486"></a><span class="lineno"> 1486</span>    <span class="keywordflow">return</span> MockSpec&lt;F&gt;(<span class="keyword">this</span>, ::std::make_tuple(std::move(m)...));</div>
<div class="line"><a id="l01487" name="l01487"></a><span class="lineno"> 1487</span>  }</div>
<div class="line"><a id="l01488" name="l01488"></a><span class="lineno"> 1488</span> </div>
<div class="line"><a id="l01489" name="l01489"></a><span class="lineno"> 1489</span> <span class="keyword">protected</span>:</div>
<div class="line"><a id="l01490" name="l01490"></a><span class="lineno"> 1490</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Function&gt;</div>
<div class="line"><a id="l01491" name="l01491"></a><span class="lineno"> 1491</span>  <span class="keyword">friend</span> <span class="keyword">class </span>MockSpec;</div>
<div class="line"><a id="l01492" name="l01492"></a><span class="lineno"> 1492</span> </div>
<div class="line"><a id="l01493" name="l01493"></a><span class="lineno"> 1493</span>  <span class="comment">// Adds and returns a default action spec for this mock function.</span></div>
<div class="line"><a id="l01494" name="l01494"></a><span class="lineno"> 1494</span>  OnCallSpec&lt;F&gt;&amp; AddNewOnCallSpec(<span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line,</div>
<div class="line"><a id="l01495" name="l01495"></a><span class="lineno"> 1495</span>                                  <span class="keyword">const</span> ArgumentMatcherTuple&amp; m)</div>
<div class="line"><a id="l01496" name="l01496"></a><span class="lineno"> 1496</span>      GTEST_LOCK_EXCLUDED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01497" name="l01497"></a><span class="lineno"> 1497</span>    Mock::RegisterUseByOnCallOrExpectCall(MockObject(), file, line);</div>
<div class="line"><a id="l01498" name="l01498"></a><span class="lineno"> 1498</span>    OnCallSpec&lt;F&gt;* <span class="keyword">const</span> on_call_spec = <span class="keyword">new</span> OnCallSpec&lt;F&gt;(file, line, m);</div>
<div class="line"><a id="l01499" name="l01499"></a><span class="lineno"> 1499</span>    untyped_on_call_specs_.push_back(on_call_spec);</div>
<div class="line"><a id="l01500" name="l01500"></a><span class="lineno"> 1500</span>    <span class="keywordflow">return</span> *on_call_spec;</div>
<div class="line"><a id="l01501" name="l01501"></a><span class="lineno"> 1501</span>  }</div>
<div class="line"><a id="l01502" name="l01502"></a><span class="lineno"> 1502</span> </div>
<div class="line"><a id="l01503" name="l01503"></a><span class="lineno"> 1503</span>  <span class="comment">// Adds and returns an expectation spec for this mock function.</span></div>
<div class="line"><a id="l01504" name="l01504"></a><span class="lineno"> 1504</span>  TypedExpectation&lt;F&gt;&amp; AddNewExpectation(<span class="keyword">const</span> <span class="keywordtype">char</span>* file, <span class="keywordtype">int</span> line,</div>
<div class="line"><a id="l01505" name="l01505"></a><span class="lineno"> 1505</span>                                         <span class="keyword">const</span> std::string&amp; source_text,</div>
<div class="line"><a id="l01506" name="l01506"></a><span class="lineno"> 1506</span>                                         <span class="keyword">const</span> ArgumentMatcherTuple&amp; m)</div>
<div class="line"><a id="l01507" name="l01507"></a><span class="lineno"> 1507</span>      GTEST_LOCK_EXCLUDED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01508" name="l01508"></a><span class="lineno"> 1508</span>    Mock::RegisterUseByOnCallOrExpectCall(MockObject(), file, line);</div>
<div class="line"><a id="l01509" name="l01509"></a><span class="lineno"> 1509</span>    TypedExpectation&lt;F&gt;* <span class="keyword">const</span> expectation =</div>
<div class="line"><a id="l01510" name="l01510"></a><span class="lineno"> 1510</span>        <span class="keyword">new</span> TypedExpectation&lt;F&gt;(<span class="keyword">this</span>, file, line, source_text, m);</div>
<div class="line"><a id="l01511" name="l01511"></a><span class="lineno"> 1511</span>    <span class="keyword">const</span> std::shared_ptr&lt;ExpectationBase&gt; untyped_expectation(expectation);</div>
<div class="line"><a id="l01512" name="l01512"></a><span class="lineno"> 1512</span>    <span class="comment">// See the definition of untyped_expectations_ for why access to</span></div>
<div class="line"><a id="l01513" name="l01513"></a><span class="lineno"> 1513</span>    <span class="comment">// it is unprotected here.</span></div>
<div class="line"><a id="l01514" name="l01514"></a><span class="lineno"> 1514</span>    untyped_expectations_.push_back(untyped_expectation);</div>
<div class="line"><a id="l01515" name="l01515"></a><span class="lineno"> 1515</span> </div>
<div class="line"><a id="l01516" name="l01516"></a><span class="lineno"> 1516</span>    <span class="comment">// Adds this expectation into the implicit sequence if there is one.</span></div>
<div class="line"><a id="l01517" name="l01517"></a><span class="lineno"> 1517</span>    Sequence* <span class="keyword">const</span> implicit_sequence = g_gmock_implicit_sequence.get();</div>
<div class="line"><a id="l01518" name="l01518"></a><span class="lineno"> 1518</span>    <span class="keywordflow">if</span> (implicit_sequence != <span class="keyword">nullptr</span>) {</div>
<div class="line"><a id="l01519" name="l01519"></a><span class="lineno"> 1519</span>      implicit_sequence-&gt;AddExpectation(Expectation(untyped_expectation));</div>
<div class="line"><a id="l01520" name="l01520"></a><span class="lineno"> 1520</span>    }</div>
<div class="line"><a id="l01521" name="l01521"></a><span class="lineno"> 1521</span> </div>
<div class="line"><a id="l01522" name="l01522"></a><span class="lineno"> 1522</span>    <span class="keywordflow">return</span> *expectation;</div>
<div class="line"><a id="l01523" name="l01523"></a><span class="lineno"> 1523</span>  }</div>
<div class="line"><a id="l01524" name="l01524"></a><span class="lineno"> 1524</span> </div>
<div class="line"><a id="l01525" name="l01525"></a><span class="lineno"> 1525</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01526" name="l01526"></a><span class="lineno"> 1526</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> Func&gt;</div>
<div class="line"><a id="l01527" name="l01527"></a><span class="lineno"> 1527</span>  <span class="keyword">friend</span> <span class="keyword">class </span>TypedExpectation;</div>
<div class="line"><a id="l01528" name="l01528"></a><span class="lineno"> 1528</span> </div>
<div class="line"><a id="l01529" name="l01529"></a><span class="lineno"> 1529</span>  <span class="comment">// Some utilities needed for implementing UntypedInvokeWith().</span></div>
<div class="line"><a id="l01530" name="l01530"></a><span class="lineno"> 1530</span> </div>
<div class="line"><a id="l01531" name="l01531"></a><span class="lineno"> 1531</span>  <span class="comment">// Describes what default action will be performed for the given</span></div>
<div class="line"><a id="l01532" name="l01532"></a><span class="lineno"> 1532</span>  <span class="comment">// arguments.</span></div>
<div class="line"><a id="l01533" name="l01533"></a><span class="lineno"> 1533</span>  <span class="comment">// L = *</span></div>
<div class="line"><a id="l01534" name="l01534"></a><span class="lineno"> 1534</span>  <span class="keywordtype">void</span> DescribeDefaultActionTo(<span class="keyword">const</span> ArgumentTuple&amp; args,</div>
<div class="line"><a id="l01535" name="l01535"></a><span class="lineno"> 1535</span>                               ::std::ostream* os)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l01536" name="l01536"></a><span class="lineno"> 1536</span>    <span class="keyword">const</span> OnCallSpec&lt;F&gt;* <span class="keyword">const</span> spec = FindOnCallSpec(args);</div>
<div class="line"><a id="l01537" name="l01537"></a><span class="lineno"> 1537</span> </div>
<div class="line"><a id="l01538" name="l01538"></a><span class="lineno"> 1538</span>    <span class="keywordflow">if</span> (spec == <span class="keyword">nullptr</span>) {</div>
<div class="line"><a id="l01539" name="l01539"></a><span class="lineno"> 1539</span>      *os &lt;&lt; (std::is_void&lt;Result&gt;::value ? <span class="stringliteral">&quot;returning directly.\n&quot;</span></div>
<div class="line"><a id="l01540" name="l01540"></a><span class="lineno"> 1540</span>                                          : <span class="stringliteral">&quot;returning default value.\n&quot;</span>);</div>
<div class="line"><a id="l01541" name="l01541"></a><span class="lineno"> 1541</span>    } <span class="keywordflow">else</span> {</div>
<div class="line"><a id="l01542" name="l01542"></a><span class="lineno"> 1542</span>      *os &lt;&lt; <span class="stringliteral">&quot;taking default action specified at:\n&quot;</span></div>
<div class="line"><a id="l01543" name="l01543"></a><span class="lineno"> 1543</span>          &lt;&lt; FormatFileLocation(spec-&gt;file(), spec-&gt;line()) &lt;&lt; <span class="stringliteral">&quot;\n&quot;</span>;</div>
<div class="line"><a id="l01544" name="l01544"></a><span class="lineno"> 1544</span>    }</div>
<div class="line"><a id="l01545" name="l01545"></a><span class="lineno"> 1545</span>  }</div>
<div class="line"><a id="l01546" name="l01546"></a><span class="lineno"> 1546</span> </div>
<div class="line"><a id="l01547" name="l01547"></a><span class="lineno"> 1547</span>  <span class="comment">// Writes a message that the call is uninteresting (i.e. neither</span></div>
<div class="line"><a id="l01548" name="l01548"></a><span class="lineno"> 1548</span>  <span class="comment">// explicitly expected nor explicitly unexpected) to the given</span></div>
<div class="line"><a id="l01549" name="l01549"></a><span class="lineno"> 1549</span>  <span class="comment">// ostream.</span></div>
<div class="line"><a id="l01550" name="l01550"></a><span class="lineno"> 1550</span>  <span class="keywordtype">void</span> UntypedDescribeUninterestingCall(<span class="keyword">const</span> <span class="keywordtype">void</span>* untyped_args,</div>
<div class="line"><a id="l01551" name="l01551"></a><span class="lineno"> 1551</span>                                        ::std::ostream* os) <span class="keyword">const</span> <span class="keyword">override</span></div>
<div class="line"><a id="l01552" name="l01552"></a><span class="lineno"> 1552</span>      GTEST_LOCK_EXCLUDED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01553" name="l01553"></a><span class="lineno"> 1553</span>    <span class="keyword">const</span> ArgumentTuple&amp; args =</div>
<div class="line"><a id="l01554" name="l01554"></a><span class="lineno"> 1554</span>        *<span class="keyword">static_cast&lt;</span><span class="keyword">const </span>ArgumentTuple*<span class="keyword">&gt;</span>(untyped_args);</div>
<div class="line"><a id="l01555" name="l01555"></a><span class="lineno"> 1555</span>    *os &lt;&lt; <span class="stringliteral">&quot;Uninteresting mock function call - &quot;</span>;</div>
<div class="line"><a id="l01556" name="l01556"></a><span class="lineno"> 1556</span>    DescribeDefaultActionTo(args, os);</div>
<div class="line"><a id="l01557" name="l01557"></a><span class="lineno"> 1557</span>    *os &lt;&lt; <span class="stringliteral">&quot;    Function call: &quot;</span> &lt;&lt; Name();</div>
<div class="line"><a id="l01558" name="l01558"></a><span class="lineno"> 1558</span>    UniversalPrint(args, os);</div>
<div class="line"><a id="l01559" name="l01559"></a><span class="lineno"> 1559</span>  }</div>
<div class="line"><a id="l01560" name="l01560"></a><span class="lineno"> 1560</span> </div>
<div class="line"><a id="l01561" name="l01561"></a><span class="lineno"> 1561</span>  <span class="comment">// Returns the expectation that matches the given function arguments</span></div>
<div class="line"><a id="l01562" name="l01562"></a><span class="lineno"> 1562</span>  <span class="comment">// (or NULL is there&#39;s no match); when a match is found,</span></div>
<div class="line"><a id="l01563" name="l01563"></a><span class="lineno"> 1563</span>  <span class="comment">// untyped_action is set to point to the action that should be</span></div>
<div class="line"><a id="l01564" name="l01564"></a><span class="lineno"> 1564</span>  <span class="comment">// performed (or NULL if the action is &quot;do default&quot;), and</span></div>
<div class="line"><a id="l01565" name="l01565"></a><span class="lineno"> 1565</span>  <span class="comment">// is_excessive is modified to indicate whether the call exceeds the</span></div>
<div class="line"><a id="l01566" name="l01566"></a><span class="lineno"> 1566</span>  <span class="comment">// expected number.</span></div>
<div class="line"><a id="l01567" name="l01567"></a><span class="lineno"> 1567</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01568" name="l01568"></a><span class="lineno"> 1568</span>  <span class="comment">// Critical section: We must find the matching expectation and the</span></div>
<div class="line"><a id="l01569" name="l01569"></a><span class="lineno"> 1569</span>  <span class="comment">// corresponding action that needs to be taken in an ATOMIC</span></div>
<div class="line"><a id="l01570" name="l01570"></a><span class="lineno"> 1570</span>  <span class="comment">// transaction.  Otherwise another thread may call this mock</span></div>
<div class="line"><a id="l01571" name="l01571"></a><span class="lineno"> 1571</span>  <span class="comment">// method in the middle and mess up the state.</span></div>
<div class="line"><a id="l01572" name="l01572"></a><span class="lineno"> 1572</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01573" name="l01573"></a><span class="lineno"> 1573</span>  <span class="comment">// However, performing the action has to be left out of the critical</span></div>
<div class="line"><a id="l01574" name="l01574"></a><span class="lineno"> 1574</span>  <span class="comment">// section.  The reason is that we have no control on what the</span></div>
<div class="line"><a id="l01575" name="l01575"></a><span class="lineno"> 1575</span>  <span class="comment">// action does (it can invoke an arbitrary user function or even a</span></div>
<div class="line"><a id="l01576" name="l01576"></a><span class="lineno"> 1576</span>  <span class="comment">// mock function) and excessive locking could cause a dead lock.</span></div>
<div class="line"><a id="l01577" name="l01577"></a><span class="lineno"> 1577</span>  <span class="keyword">const</span> ExpectationBase* UntypedFindMatchingExpectation(</div>
<div class="line"><a id="l01578" name="l01578"></a><span class="lineno"> 1578</span>      <span class="keyword">const</span> <span class="keywordtype">void</span>* untyped_args, <span class="keyword">const</span> <span class="keywordtype">void</span>** untyped_action, <span class="keywordtype">bool</span>* is_excessive,</div>
<div class="line"><a id="l01579" name="l01579"></a><span class="lineno"> 1579</span>      ::std::ostream* what, ::std::ostream* why) <span class="keyword">override</span></div>
<div class="line"><a id="l01580" name="l01580"></a><span class="lineno"> 1580</span>      GTEST_LOCK_EXCLUDED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01581" name="l01581"></a><span class="lineno"> 1581</span>    <span class="keyword">const</span> ArgumentTuple&amp; args =</div>
<div class="line"><a id="l01582" name="l01582"></a><span class="lineno"> 1582</span>        *<span class="keyword">static_cast&lt;</span><span class="keyword">const </span>ArgumentTuple*<span class="keyword">&gt;</span>(untyped_args);</div>
<div class="line"><a id="l01583" name="l01583"></a><span class="lineno"> 1583</span>    MutexLock l(&amp;g_gmock_mutex);</div>
<div class="line"><a id="l01584" name="l01584"></a><span class="lineno"> 1584</span>    TypedExpectation&lt;F&gt;* exp = this-&gt;FindMatchingExpectationLocked(args);</div>
<div class="line"><a id="l01585" name="l01585"></a><span class="lineno"> 1585</span>    <span class="keywordflow">if</span> (exp == <span class="keyword">nullptr</span>) {  <span class="comment">// A match wasn&#39;t found.</span></div>
<div class="line"><a id="l01586" name="l01586"></a><span class="lineno"> 1586</span>      this-&gt;FormatUnexpectedCallMessageLocked(args, what, why);</div>
<div class="line"><a id="l01587" name="l01587"></a><span class="lineno"> 1587</span>      <span class="keywordflow">return</span> <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l01588" name="l01588"></a><span class="lineno"> 1588</span>    }</div>
<div class="line"><a id="l01589" name="l01589"></a><span class="lineno"> 1589</span> </div>
<div class="line"><a id="l01590" name="l01590"></a><span class="lineno"> 1590</span>    <span class="comment">// This line must be done before calling GetActionForArguments(),</span></div>
<div class="line"><a id="l01591" name="l01591"></a><span class="lineno"> 1591</span>    <span class="comment">// which will increment the call count for *exp and thus affect</span></div>
<div class="line"><a id="l01592" name="l01592"></a><span class="lineno"> 1592</span>    <span class="comment">// its saturation status.</span></div>
<div class="line"><a id="l01593" name="l01593"></a><span class="lineno"> 1593</span>    *is_excessive = exp-&gt;IsSaturated();</div>
<div class="line"><a id="l01594" name="l01594"></a><span class="lineno"> 1594</span>    <span class="keyword">const</span> Action&lt;F&gt;* action = exp-&gt;GetActionForArguments(<span class="keyword">this</span>, args, what, why);</div>
<div class="line"><a id="l01595" name="l01595"></a><span class="lineno"> 1595</span>    <span class="keywordflow">if</span> (action != <span class="keyword">nullptr</span> &amp;&amp; action-&gt;IsDoDefault())</div>
<div class="line"><a id="l01596" name="l01596"></a><span class="lineno"> 1596</span>      action = <span class="keyword">nullptr</span>;  <span class="comment">// Normalize &quot;do default&quot; to NULL.</span></div>
<div class="line"><a id="l01597" name="l01597"></a><span class="lineno"> 1597</span>    *untyped_action = action;</div>
<div class="line"><a id="l01598" name="l01598"></a><span class="lineno"> 1598</span>    <span class="keywordflow">return</span> exp;</div>
<div class="line"><a id="l01599" name="l01599"></a><span class="lineno"> 1599</span>  }</div>
<div class="line"><a id="l01600" name="l01600"></a><span class="lineno"> 1600</span> </div>
<div class="line"><a id="l01601" name="l01601"></a><span class="lineno"> 1601</span>  <span class="comment">// Prints the given function arguments to the ostream.</span></div>
<div class="line"><a id="l01602" name="l01602"></a><span class="lineno"> 1602</span>  <span class="keywordtype">void</span> UntypedPrintArgs(<span class="keyword">const</span> <span class="keywordtype">void</span>* untyped_args,</div>
<div class="line"><a id="l01603" name="l01603"></a><span class="lineno"> 1603</span>                        ::std::ostream* os)<span class="keyword"> const override </span>{</div>
<div class="line"><a id="l01604" name="l01604"></a><span class="lineno"> 1604</span>    <span class="keyword">const</span> ArgumentTuple&amp; args =</div>
<div class="line"><a id="l01605" name="l01605"></a><span class="lineno"> 1605</span>        *<span class="keyword">static_cast&lt;</span><span class="keyword">const </span>ArgumentTuple*<span class="keyword">&gt;</span>(untyped_args);</div>
<div class="line"><a id="l01606" name="l01606"></a><span class="lineno"> 1606</span>    UniversalPrint(args, os);</div>
<div class="line"><a id="l01607" name="l01607"></a><span class="lineno"> 1607</span>  }</div>
<div class="line"><a id="l01608" name="l01608"></a><span class="lineno"> 1608</span> </div>
<div class="line"><a id="l01609" name="l01609"></a><span class="lineno"> 1609</span>  <span class="comment">// Returns the expectation that matches the arguments, or NULL if no</span></div>
<div class="line"><a id="l01610" name="l01610"></a><span class="lineno"> 1610</span>  <span class="comment">// expectation matches them.</span></div>
<div class="line"><a id="l01611" name="l01611"></a><span class="lineno"> 1611</span>  TypedExpectation&lt;F&gt;* FindMatchingExpectationLocked(<span class="keyword">const</span> ArgumentTuple&amp; args)</div>
<div class="line"><a id="l01612" name="l01612"></a><span class="lineno"> 1612</span>      <span class="keyword">const</span> GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01613" name="l01613"></a><span class="lineno"> 1613</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l01614" name="l01614"></a><span class="lineno"> 1614</span>    <span class="comment">// See the definition of untyped_expectations_ for why access to</span></div>
<div class="line"><a id="l01615" name="l01615"></a><span class="lineno"> 1615</span>    <span class="comment">// it is unprotected here.</span></div>
<div class="line"><a id="l01616" name="l01616"></a><span class="lineno"> 1616</span>    <span class="keywordflow">for</span> (<span class="keyword">typename</span> UntypedExpectations::const_reverse_iterator it =</div>
<div class="line"><a id="l01617" name="l01617"></a><span class="lineno"> 1617</span>             untyped_expectations_.rbegin();</div>
<div class="line"><a id="l01618" name="l01618"></a><span class="lineno"> 1618</span>         it != untyped_expectations_.rend(); ++it) {</div>
<div class="line"><a id="l01619" name="l01619"></a><span class="lineno"> 1619</span>      TypedExpectation&lt;F&gt;* <span class="keyword">const</span> exp =</div>
<div class="line"><a id="l01620" name="l01620"></a><span class="lineno"> 1620</span>          <span class="keyword">static_cast&lt;</span>TypedExpectation&lt;F&gt;*<span class="keyword">&gt;</span>(it-&gt;get());</div>
<div class="line"><a id="l01621" name="l01621"></a><span class="lineno"> 1621</span>      <span class="keywordflow">if</span> (exp-&gt;ShouldHandleArguments(args)) {</div>
<div class="line"><a id="l01622" name="l01622"></a><span class="lineno"> 1622</span>        <span class="keywordflow">return</span> exp;</div>
<div class="line"><a id="l01623" name="l01623"></a><span class="lineno"> 1623</span>      }</div>
<div class="line"><a id="l01624" name="l01624"></a><span class="lineno"> 1624</span>    }</div>
<div class="line"><a id="l01625" name="l01625"></a><span class="lineno"> 1625</span>    <span class="keywordflow">return</span> <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l01626" name="l01626"></a><span class="lineno"> 1626</span>  }</div>
<div class="line"><a id="l01627" name="l01627"></a><span class="lineno"> 1627</span> </div>
<div class="line"><a id="l01628" name="l01628"></a><span class="lineno"> 1628</span>  <span class="comment">// Returns a message that the arguments don&#39;t match any expectation.</span></div>
<div class="line"><a id="l01629" name="l01629"></a><span class="lineno"> 1629</span>  <span class="keywordtype">void</span> FormatUnexpectedCallMessageLocked(<span class="keyword">const</span> ArgumentTuple&amp; args,</div>
<div class="line"><a id="l01630" name="l01630"></a><span class="lineno"> 1630</span>                                         ::std::ostream* os,</div>
<div class="line"><a id="l01631" name="l01631"></a><span class="lineno"> 1631</span>                                         ::std::ostream* why) <span class="keyword">const</span></div>
<div class="line"><a id="l01632" name="l01632"></a><span class="lineno"> 1632</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01633" name="l01633"></a><span class="lineno"> 1633</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l01634" name="l01634"></a><span class="lineno"> 1634</span>    *os &lt;&lt; <span class="stringliteral">&quot;\nUnexpected mock function call - &quot;</span>;</div>
<div class="line"><a id="l01635" name="l01635"></a><span class="lineno"> 1635</span>    DescribeDefaultActionTo(args, os);</div>
<div class="line"><a id="l01636" name="l01636"></a><span class="lineno"> 1636</span>    PrintTriedExpectationsLocked(args, why);</div>
<div class="line"><a id="l01637" name="l01637"></a><span class="lineno"> 1637</span>  }</div>
<div class="line"><a id="l01638" name="l01638"></a><span class="lineno"> 1638</span> </div>
<div class="line"><a id="l01639" name="l01639"></a><span class="lineno"> 1639</span>  <span class="comment">// Prints a list of expectations that have been tried against the</span></div>
<div class="line"><a id="l01640" name="l01640"></a><span class="lineno"> 1640</span>  <span class="comment">// current mock function call.</span></div>
<div class="line"><a id="l01641" name="l01641"></a><span class="lineno"> 1641</span>  <span class="keywordtype">void</span> PrintTriedExpectationsLocked(<span class="keyword">const</span> ArgumentTuple&amp; args,</div>
<div class="line"><a id="l01642" name="l01642"></a><span class="lineno"> 1642</span>                                    ::std::ostream* why) <span class="keyword">const</span></div>
<div class="line"><a id="l01643" name="l01643"></a><span class="lineno"> 1643</span>      GTEST_EXCLUSIVE_LOCK_REQUIRED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01644" name="l01644"></a><span class="lineno"> 1644</span>    g_gmock_mutex.AssertHeld();</div>
<div class="line"><a id="l01645" name="l01645"></a><span class="lineno"> 1645</span>    <span class="keyword">const</span> <span class="keywordtype">size_t</span> count = untyped_expectations_.size();</div>
<div class="line"><a id="l01646" name="l01646"></a><span class="lineno"> 1646</span>    *why &lt;&lt; <span class="stringliteral">&quot;Google Mock tried the following &quot;</span> &lt;&lt; count &lt;&lt; <span class="stringliteral">&quot; &quot;</span></div>
<div class="line"><a id="l01647" name="l01647"></a><span class="lineno"> 1647</span>         &lt;&lt; (count == 1 ? <span class="stringliteral">&quot;expectation, but it didn&#39;t match&quot;</span></div>
<div class="line"><a id="l01648" name="l01648"></a><span class="lineno"> 1648</span>                        : <span class="stringliteral">&quot;expectations, but none matched&quot;</span>)</div>
<div class="line"><a id="l01649" name="l01649"></a><span class="lineno"> 1649</span>         &lt;&lt; <span class="stringliteral">&quot;:\n&quot;</span>;</div>
<div class="line"><a id="l01650" name="l01650"></a><span class="lineno"> 1650</span>    <span class="keywordflow">for</span> (<span class="keywordtype">size_t</span> i = 0; i &lt; count; i++) {</div>
<div class="line"><a id="l01651" name="l01651"></a><span class="lineno"> 1651</span>      TypedExpectation&lt;F&gt;* <span class="keyword">const</span> expectation =</div>
<div class="line"><a id="l01652" name="l01652"></a><span class="lineno"> 1652</span>          <span class="keyword">static_cast&lt;</span>TypedExpectation&lt;F&gt;*<span class="keyword">&gt;</span>(untyped_expectations_[i].get());</div>
<div class="line"><a id="l01653" name="l01653"></a><span class="lineno"> 1653</span>      *why &lt;&lt; <span class="stringliteral">&quot;\n&quot;</span>;</div>
<div class="line"><a id="l01654" name="l01654"></a><span class="lineno"> 1654</span>      expectation-&gt;DescribeLocationTo(why);</div>
<div class="line"><a id="l01655" name="l01655"></a><span class="lineno"> 1655</span>      <span class="keywordflow">if</span> (count &gt; 1) {</div>
<div class="line"><a id="l01656" name="l01656"></a><span class="lineno"> 1656</span>        *why &lt;&lt; <span class="stringliteral">&quot;tried expectation #&quot;</span> &lt;&lt; i &lt;&lt; <span class="stringliteral">&quot;: &quot;</span>;</div>
<div class="line"><a id="l01657" name="l01657"></a><span class="lineno"> 1657</span>      }</div>
<div class="line"><a id="l01658" name="l01658"></a><span class="lineno"> 1658</span>      *why &lt;&lt; expectation-&gt;source_text() &lt;&lt; <span class="stringliteral">&quot;...\n&quot;</span>;</div>
<div class="line"><a id="l01659" name="l01659"></a><span class="lineno"> 1659</span>      expectation-&gt;ExplainMatchResultTo(args, why);</div>
<div class="line"><a id="l01660" name="l01660"></a><span class="lineno"> 1660</span>      expectation-&gt;DescribeCallCountTo(why);</div>
<div class="line"><a id="l01661" name="l01661"></a><span class="lineno"> 1661</span>    }</div>
<div class="line"><a id="l01662" name="l01662"></a><span class="lineno"> 1662</span>  }</div>
<div class="line"><a id="l01663" name="l01663"></a><span class="lineno"> 1663</span> </div>
<div class="line"><a id="l01664" name="l01664"></a><span class="lineno"> 1664</span>  <span class="comment">// Performs the given action (or the default if it&#39;s null) with the given</span></div>
<div class="line"><a id="l01665" name="l01665"></a><span class="lineno"> 1665</span>  <span class="comment">// arguments and returns the action&#39;s result.</span></div>
<div class="line"><a id="l01666" name="l01666"></a><span class="lineno"> 1666</span>  <span class="comment">// L = *</span></div>
<div class="line"><a id="l01667" name="l01667"></a><span class="lineno"> 1667</span>  R PerformAction(<span class="keyword">const</span> <span class="keywordtype">void</span>* untyped_action, ArgumentTuple&amp;&amp; args,</div>
<div class="line"><a id="l01668" name="l01668"></a><span class="lineno"> 1668</span>                  <span class="keyword">const</span> std::string&amp; call_description)<span class="keyword"> const </span>{</div>
<div class="line"><a id="l01669" name="l01669"></a><span class="lineno"> 1669</span>    <span class="keywordflow">if</span> (untyped_action == <span class="keyword">nullptr</span>) {</div>
<div class="line"><a id="l01670" name="l01670"></a><span class="lineno"> 1670</span>      <span class="keywordflow">return</span> PerformDefaultAction(std::move(args), call_description);</div>
<div class="line"><a id="l01671" name="l01671"></a><span class="lineno"> 1671</span>    }</div>
<div class="line"><a id="l01672" name="l01672"></a><span class="lineno"> 1672</span> </div>
<div class="line"><a id="l01673" name="l01673"></a><span class="lineno"> 1673</span>    <span class="comment">// Make a copy of the action before performing it, in case the</span></div>
<div class="line"><a id="l01674" name="l01674"></a><span class="lineno"> 1674</span>    <span class="comment">// action deletes the mock object (and thus deletes itself).</span></div>
<div class="line"><a id="l01675" name="l01675"></a><span class="lineno"> 1675</span>    <span class="keyword">const</span> Action&lt;F&gt; action = *<span class="keyword">static_cast&lt;</span><span class="keyword">const </span>Action&lt;F&gt;*<span class="keyword">&gt;</span>(untyped_action);</div>
<div class="line"><a id="l01676" name="l01676"></a><span class="lineno"> 1676</span>    <span class="keywordflow">return</span> action.Perform(std::move(args));</div>
<div class="line"><a id="l01677" name="l01677"></a><span class="lineno"> 1677</span>  }</div>
<div class="line"><a id="l01678" name="l01678"></a><span class="lineno"> 1678</span> </div>
<div class="line"><a id="l01679" name="l01679"></a><span class="lineno"> 1679</span>  <span class="comment">// Is it possible to store an object of the supplied type in a local variable</span></div>
<div class="line"><a id="l01680" name="l01680"></a><span class="lineno"> 1680</span>  <span class="comment">// for the sake of printing it, then return it on to the caller?</span></div>
<div class="line"><a id="l01681" name="l01681"></a><span class="lineno"> 1681</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="line"><a id="l01682" name="l01682"></a><span class="lineno"> 1682</span>  <span class="keyword">using </span>can_print_result = internal::conjunction&lt;</div>
<div class="line"><a id="l01683" name="l01683"></a><span class="lineno"> 1683</span>      <span class="comment">// void can&#39;t be stored as an object (and we also don&#39;t need to print it).</span></div>
<div class="line"><a id="l01684" name="l01684"></a><span class="lineno"> 1684</span>      internal::negation&lt;std::is_void&lt;T&gt;&gt;,</div>
<div class="line"><a id="l01685" name="l01685"></a><span class="lineno"> 1685</span>      <span class="comment">// Non-moveable types can&#39;t be returned on to the user, so there&#39;s no way</span></div>
<div class="line"><a id="l01686" name="l01686"></a><span class="lineno"> 1686</span>      <span class="comment">// for us to intercept and print them.</span></div>
<div class="line"><a id="l01687" name="l01687"></a><span class="lineno"> 1687</span>      std::is_move_constructible&lt;T&gt;&gt;;</div>
<div class="line"><a id="l01688" name="l01688"></a><span class="lineno"> 1688</span> </div>
<div class="line"><a id="l01689" name="l01689"></a><span class="lineno"> 1689</span>  <span class="comment">// Perform the supplied action, printing the result to os.</span></div>
<div class="line"><a id="l01690" name="l01690"></a><span class="lineno"> 1690</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> T = R,</div>
<div class="line"><a id="l01691" name="l01691"></a><span class="lineno"> 1691</span>            <span class="keyword">typename</span> std::enable_if&lt;can_print_result&lt;T&gt;::value, <span class="keywordtype">int</span>&gt;::type = 0&gt;</div>
<div class="line"><a id="l01692" name="l01692"></a><span class="lineno"> 1692</span>  R PerformActionAndPrintResult(<span class="keyword">const</span> <span class="keywordtype">void</span>* <span class="keyword">const</span> untyped_action,</div>
<div class="line"><a id="l01693" name="l01693"></a><span class="lineno"> 1693</span>                                ArgumentTuple&amp;&amp; args,</div>
<div class="line"><a id="l01694" name="l01694"></a><span class="lineno"> 1694</span>                                <span class="keyword">const</span> std::string&amp; call_description,</div>
<div class="line"><a id="l01695" name="l01695"></a><span class="lineno"> 1695</span>                                std::ostream&amp; os) {</div>
<div class="line"><a id="l01696" name="l01696"></a><span class="lineno"> 1696</span>    R result = PerformAction(untyped_action, std::move(args), call_description);</div>
<div class="line"><a id="l01697" name="l01697"></a><span class="lineno"> 1697</span> </div>
<div class="line"><a id="l01698" name="l01698"></a><span class="lineno"> 1698</span>    PrintAsActionResult(result, os);</div>
<div class="line"><a id="l01699" name="l01699"></a><span class="lineno"> 1699</span>    <span class="keywordflow">return</span> std::forward&lt;R&gt;(result);</div>
<div class="line"><a id="l01700" name="l01700"></a><span class="lineno"> 1700</span>  }</div>
<div class="line"><a id="l01701" name="l01701"></a><span class="lineno"> 1701</span> </div>
<div class="line"><a id="l01702" name="l01702"></a><span class="lineno"> 1702</span>  <span class="comment">// An overload for when it&#39;s not possible to print the result. In this case we</span></div>
<div class="line"><a id="l01703" name="l01703"></a><span class="lineno"> 1703</span>  <span class="comment">// simply perform the action.</span></div>
<div class="line"><a id="l01704" name="l01704"></a><span class="lineno"> 1704</span>  <span class="keyword">template</span> &lt;<span class="keyword">typename</span> T = R,</div>
<div class="line"><a id="l01705" name="l01705"></a><span class="lineno"> 1705</span>            <span class="keyword">typename</span> std::enable_if&lt;</div>
<div class="line"><a id="l01706" name="l01706"></a><span class="lineno"> 1706</span>                internal::negation&lt;can_print_result&lt;T&gt;&gt;::value, <span class="keywordtype">int</span>&gt;::type = 0&gt;</div>
<div class="line"><a id="l01707" name="l01707"></a><span class="lineno"> 1707</span>  R PerformActionAndPrintResult(<span class="keyword">const</span> <span class="keywordtype">void</span>* <span class="keyword">const</span> untyped_action,</div>
<div class="line"><a id="l01708" name="l01708"></a><span class="lineno"> 1708</span>                                ArgumentTuple&amp;&amp; args,</div>
<div class="line"><a id="l01709" name="l01709"></a><span class="lineno"> 1709</span>                                <span class="keyword">const</span> std::string&amp; call_description,</div>
<div class="line"><a id="l01710" name="l01710"></a><span class="lineno"> 1710</span>                                std::ostream&amp;) {</div>
<div class="line"><a id="l01711" name="l01711"></a><span class="lineno"> 1711</span>    <span class="keywordflow">return</span> PerformAction(untyped_action, std::move(args), call_description);</div>
<div class="line"><a id="l01712" name="l01712"></a><span class="lineno"> 1712</span>  }</div>
<div class="line"><a id="l01713" name="l01713"></a><span class="lineno"> 1713</span> </div>
<div class="line"><a id="l01714" name="l01714"></a><span class="lineno"> 1714</span>  <span class="comment">// Returns the result of invoking this mock function with the given</span></div>
<div class="line"><a id="l01715" name="l01715"></a><span class="lineno"> 1715</span>  <span class="comment">// arguments. This function can be safely called from multiple</span></div>
<div class="line"><a id="l01716" name="l01716"></a><span class="lineno"> 1716</span>  <span class="comment">// threads concurrently.</span></div>
<div class="line"><a id="l01717" name="l01717"></a><span class="lineno"> 1717</span>  R InvokeWith(ArgumentTuple&amp;&amp; args) GTEST_LOCK_EXCLUDED_(g_gmock_mutex);</div>
<div class="line"><a id="l01718" name="l01718"></a><span class="lineno"> 1718</span>};  <span class="comment">// class FunctionMocker</span></div>
<div class="line"><a id="l01719" name="l01719"></a><span class="lineno"> 1719</span> </div>
<div class="line"><a id="l01720" name="l01720"></a><span class="lineno"> 1720</span><span class="comment">// Calculates the result of invoking this mock function with the given</span></div>
<div class="line"><a id="l01721" name="l01721"></a><span class="lineno"> 1721</span><span class="comment">// arguments, prints it, and returns it.</span></div>
<div class="line"><a id="l01722" name="l01722"></a><span class="lineno"> 1722</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> R, <span class="keyword">typename</span>... Args&gt;</div>
<div class="line"><a id="l01723" name="l01723"></a><span class="lineno"> 1723</span>R FunctionMocker&lt;R(Args...)&gt;::InvokeWith(ArgumentTuple&amp;&amp; args)</div>
<div class="line"><a id="l01724" name="l01724"></a><span class="lineno"> 1724</span>    GTEST_LOCK_EXCLUDED_(g_gmock_mutex) {</div>
<div class="line"><a id="l01725" name="l01725"></a><span class="lineno"> 1725</span>  <span class="comment">// See the definition of untyped_expectations_ for why access to it</span></div>
<div class="line"><a id="l01726" name="l01726"></a><span class="lineno"> 1726</span>  <span class="comment">// is unprotected here.</span></div>
<div class="line"><a id="l01727" name="l01727"></a><span class="lineno"> 1727</span>  <span class="keywordflow">if</span> (untyped_expectations_.size() == 0) {</div>
<div class="line"><a id="l01728" name="l01728"></a><span class="lineno"> 1728</span>    <span class="comment">// No expectation is set on this mock method - we have an</span></div>
<div class="line"><a id="l01729" name="l01729"></a><span class="lineno"> 1729</span>    <span class="comment">// uninteresting call.</span></div>
<div class="line"><a id="l01730" name="l01730"></a><span class="lineno"> 1730</span> </div>
<div class="line"><a id="l01731" name="l01731"></a><span class="lineno"> 1731</span>    <span class="comment">// We must get Google Mock&#39;s reaction on uninteresting calls</span></div>
<div class="line"><a id="l01732" name="l01732"></a><span class="lineno"> 1732</span>    <span class="comment">// made on this mock object BEFORE performing the action,</span></div>
<div class="line"><a id="l01733" name="l01733"></a><span class="lineno"> 1733</span>    <span class="comment">// because the action may DELETE the mock object and make the</span></div>
<div class="line"><a id="l01734" name="l01734"></a><span class="lineno"> 1734</span>    <span class="comment">// following expression meaningless.</span></div>
<div class="line"><a id="l01735" name="l01735"></a><span class="lineno"> 1735</span>    <span class="keyword">const</span> CallReaction reaction =</div>
<div class="line"><a id="l01736" name="l01736"></a><span class="lineno"> 1736</span>        Mock::GetReactionOnUninterestingCalls(MockObject());</div>
<div class="line"><a id="l01737" name="l01737"></a><span class="lineno"> 1737</span> </div>
<div class="line"><a id="l01738" name="l01738"></a><span class="lineno"> 1738</span>    <span class="comment">// True if and only if we need to print this call&#39;s arguments and return</span></div>
<div class="line"><a id="l01739" name="l01739"></a><span class="lineno"> 1739</span>    <span class="comment">// value.  This definition must be kept in sync with</span></div>
<div class="line"><a id="l01740" name="l01740"></a><span class="lineno"> 1740</span>    <span class="comment">// the behavior of ReportUninterestingCall().</span></div>
<div class="line"><a id="l01741" name="l01741"></a><span class="lineno"> 1741</span>    <span class="keyword">const</span> <span class="keywordtype">bool</span> need_to_report_uninteresting_call =</div>
<div class="line"><a id="l01742" name="l01742"></a><span class="lineno"> 1742</span>        <span class="comment">// If the user allows this uninteresting call, we print it</span></div>
<div class="line"><a id="l01743" name="l01743"></a><span class="lineno"> 1743</span>        <span class="comment">// only when they want informational messages.</span></div>
<div class="line"><a id="l01744" name="l01744"></a><span class="lineno"> 1744</span>        reaction == kAllow ? LogIsVisible(kInfo) :</div>
<div class="line"><a id="l01745" name="l01745"></a><span class="lineno"> 1745</span>                           <span class="comment">// If the user wants this to be a warning, we print</span></div>
<div class="line"><a id="l01746" name="l01746"></a><span class="lineno"> 1746</span>                           <span class="comment">// it only when they want to see warnings.</span></div>
<div class="line"><a id="l01747" name="l01747"></a><span class="lineno"> 1747</span>            reaction == kWarn</div>
<div class="line"><a id="l01748" name="l01748"></a><span class="lineno"> 1748</span>            ? LogIsVisible(kWarning)</div>
<div class="line"><a id="l01749" name="l01749"></a><span class="lineno"> 1749</span>            :</div>
<div class="line"><a id="l01750" name="l01750"></a><span class="lineno"> 1750</span>            <span class="comment">// Otherwise, the user wants this to be an error, and we</span></div>
<div class="line"><a id="l01751" name="l01751"></a><span class="lineno"> 1751</span>            <span class="comment">// should always print detailed information in the error.</span></div>
<div class="line"><a id="l01752" name="l01752"></a><span class="lineno"> 1752</span>            true;</div>
<div class="line"><a id="l01753" name="l01753"></a><span class="lineno"> 1753</span> </div>
<div class="line"><a id="l01754" name="l01754"></a><span class="lineno"> 1754</span>    <span class="keywordflow">if</span> (!need_to_report_uninteresting_call) {</div>
<div class="line"><a id="l01755" name="l01755"></a><span class="lineno"> 1755</span>      <span class="comment">// Perform the action without printing the call information.</span></div>
<div class="line"><a id="l01756" name="l01756"></a><span class="lineno"> 1756</span>      <span class="keywordflow">return</span> this-&gt;PerformDefaultAction(</div>
<div class="line"><a id="l01757" name="l01757"></a><span class="lineno"> 1757</span>          std::move(args), <span class="stringliteral">&quot;Function call: &quot;</span> + std::string(Name()));</div>
<div class="line"><a id="l01758" name="l01758"></a><span class="lineno"> 1758</span>    }</div>
<div class="line"><a id="l01759" name="l01759"></a><span class="lineno"> 1759</span> </div>
<div class="line"><a id="l01760" name="l01760"></a><span class="lineno"> 1760</span>    <span class="comment">// Warns about the uninteresting call.</span></div>
<div class="line"><a id="l01761" name="l01761"></a><span class="lineno"> 1761</span>    ::std::stringstream ss;</div>
<div class="line"><a id="l01762" name="l01762"></a><span class="lineno"> 1762</span>    this-&gt;UntypedDescribeUninterestingCall(&amp;args, &amp;ss);</div>
<div class="line"><a id="l01763" name="l01763"></a><span class="lineno"> 1763</span> </div>
<div class="line"><a id="l01764" name="l01764"></a><span class="lineno"> 1764</span>    <span class="comment">// Perform the action, print the result, and then report the uninteresting</span></div>
<div class="line"><a id="l01765" name="l01765"></a><span class="lineno"> 1765</span>    <span class="comment">// call.</span></div>
<div class="line"><a id="l01766" name="l01766"></a><span class="lineno"> 1766</span>    <span class="comment">//</span></div>
<div class="line"><a id="l01767" name="l01767"></a><span class="lineno"> 1767</span>    <span class="comment">// We use RAII to do the latter in case R is void or a non-moveable type. In</span></div>
<div class="line"><a id="l01768" name="l01768"></a><span class="lineno"> 1768</span>    <span class="comment">// either case we can&#39;t assign it to a local variable.</span></div>
<div class="line"><a id="l01769" name="l01769"></a><span class="lineno"> 1769</span>    <span class="keyword">const</span> Cleanup report_uninteresting_call(</div>
<div class="line"><a id="l01770" name="l01770"></a><span class="lineno"> 1770</span>        [&amp;] { ReportUninterestingCall(reaction, ss.str()); });</div>
<div class="line"><a id="l01771" name="l01771"></a><span class="lineno"> 1771</span> </div>
<div class="line"><a id="l01772" name="l01772"></a><span class="lineno"> 1772</span>    <span class="keywordflow">return</span> PerformActionAndPrintResult(<span class="keyword">nullptr</span>, std::move(args), ss.str(), ss);</div>
<div class="line"><a id="l01773" name="l01773"></a><span class="lineno"> 1773</span>  }</div>
<div class="line"><a id="l01774" name="l01774"></a><span class="lineno"> 1774</span> </div>
<div class="line"><a id="l01775" name="l01775"></a><span class="lineno"> 1775</span>  <span class="keywordtype">bool</span> is_excessive = <span class="keyword">false</span>;</div>
<div class="line"><a id="l01776" name="l01776"></a><span class="lineno"> 1776</span>  ::std::stringstream ss;</div>
<div class="line"><a id="l01777" name="l01777"></a><span class="lineno"> 1777</span>  ::std::stringstream why;</div>
<div class="line"><a id="l01778" name="l01778"></a><span class="lineno"> 1778</span>  ::std::stringstream loc;</div>
<div class="line"><a id="l01779" name="l01779"></a><span class="lineno"> 1779</span>  <span class="keyword">const</span> <span class="keywordtype">void</span>* untyped_action = <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l01780" name="l01780"></a><span class="lineno"> 1780</span> </div>
<div class="line"><a id="l01781" name="l01781"></a><span class="lineno"> 1781</span>  <span class="comment">// The UntypedFindMatchingExpectation() function acquires and</span></div>
<div class="line"><a id="l01782" name="l01782"></a><span class="lineno"> 1782</span>  <span class="comment">// releases g_gmock_mutex.</span></div>
<div class="line"><a id="l01783" name="l01783"></a><span class="lineno"> 1783</span> </div>
<div class="line"><a id="l01784" name="l01784"></a><span class="lineno"> 1784</span>  <span class="keyword">const</span> ExpectationBase* <span class="keyword">const</span> untyped_expectation =</div>
<div class="line"><a id="l01785" name="l01785"></a><span class="lineno"> 1785</span>      this-&gt;UntypedFindMatchingExpectation(&amp;args, &amp;untyped_action,</div>
<div class="line"><a id="l01786" name="l01786"></a><span class="lineno"> 1786</span>                                           &amp;is_excessive, &amp;ss, &amp;why);</div>
<div class="line"><a id="l01787" name="l01787"></a><span class="lineno"> 1787</span>  <span class="keyword">const</span> <span class="keywordtype">bool</span> found = untyped_expectation != <span class="keyword">nullptr</span>;</div>
<div class="line"><a id="l01788" name="l01788"></a><span class="lineno"> 1788</span> </div>
<div class="line"><a id="l01789" name="l01789"></a><span class="lineno"> 1789</span>  <span class="comment">// True if and only if we need to print the call&#39;s arguments</span></div>
<div class="line"><a id="l01790" name="l01790"></a><span class="lineno"> 1790</span>  <span class="comment">// and return value.</span></div>
<div class="line"><a id="l01791" name="l01791"></a><span class="lineno"> 1791</span>  <span class="comment">// This definition must be kept in sync with the uses of Expect()</span></div>
<div class="line"><a id="l01792" name="l01792"></a><span class="lineno"> 1792</span>  <span class="comment">// and Log() in this function.</span></div>
<div class="line"><a id="l01793" name="l01793"></a><span class="lineno"> 1793</span>  <span class="keyword">const</span> <span class="keywordtype">bool</span> need_to_report_call =</div>
<div class="line"><a id="l01794" name="l01794"></a><span class="lineno"> 1794</span>      !found || is_excessive || LogIsVisible(kInfo);</div>
<div class="line"><a id="l01795" name="l01795"></a><span class="lineno"> 1795</span>  <span class="keywordflow">if</span> (!need_to_report_call) {</div>
<div class="line"><a id="l01796" name="l01796"></a><span class="lineno"> 1796</span>    <span class="comment">// Perform the action without printing the call information.</span></div>
<div class="line"><a id="l01797" name="l01797"></a><span class="lineno"> 1797</span>    <span class="keywordflow">return</span> PerformAction(untyped_action, std::move(args), <span class="stringliteral">&quot;&quot;</span>);</div>
<div class="line"><a id="l01798" name="l01798"></a><span class="lineno"> 1798</span>  }</div>
<div class="line"><a id="l01799" name="l01799"></a><span class="lineno"> 1799</span> </div>
<div class="line"><a id="l01800" name="l01800"></a><span class="lineno"> 1800</span>  ss &lt;&lt; <span class="stringliteral">&quot;    Function call: &quot;</span> &lt;&lt; Name();</div>
<div class="line"><a id="l01801" name="l01801"></a><span class="lineno"> 1801</span>  this-&gt;UntypedPrintArgs(&amp;args, &amp;ss);</div>
<div class="line"><a id="l01802" name="l01802"></a><span class="lineno"> 1802</span> </div>
<div class="line"><a id="l01803" name="l01803"></a><span class="lineno"> 1803</span>  <span class="comment">// In case the action deletes a piece of the expectation, we</span></div>
<div class="line"><a id="l01804" name="l01804"></a><span class="lineno"> 1804</span>  <span class="comment">// generate the message beforehand.</span></div>
<div class="line"><a id="l01805" name="l01805"></a><span class="lineno"> 1805</span>  <span class="keywordflow">if</span> (found &amp;&amp; !is_excessive) {</div>
<div class="line"><a id="l01806" name="l01806"></a><span class="lineno"> 1806</span>    untyped_expectation-&gt;DescribeLocationTo(&amp;loc);</div>
<div class="line"><a id="l01807" name="l01807"></a><span class="lineno"> 1807</span>  }</div>
<div class="line"><a id="l01808" name="l01808"></a><span class="lineno"> 1808</span> </div>
<div class="line"><a id="l01809" name="l01809"></a><span class="lineno"> 1809</span>  <span class="comment">// Perform the action, print the result, and then fail or log in whatever way</span></div>
<div class="line"><a id="l01810" name="l01810"></a><span class="lineno"> 1810</span>  <span class="comment">// is appropriate.</span></div>
<div class="line"><a id="l01811" name="l01811"></a><span class="lineno"> 1811</span>  <span class="comment">//</span></div>
<div class="line"><a id="l01812" name="l01812"></a><span class="lineno"> 1812</span>  <span class="comment">// We use RAII to do the latter in case R is void or a non-moveable type. In</span></div>
<div class="line"><a id="l01813" name="l01813"></a><span class="lineno"> 1813</span>  <span class="comment">// either case we can&#39;t assign it to a local variable.</span></div>
<div class="line"><a id="l01814" name="l01814"></a><span class="lineno"> 1814</span>  <span class="keyword">const</span> Cleanup handle_failures([&amp;] {</div>
<div class="line"><a id="l01815" name="l01815"></a><span class="lineno"> 1815</span>    ss &lt;&lt; <span class="stringliteral">&quot;\n&quot;</span> &lt;&lt; why.str();</div>
<div class="line"><a id="l01816" name="l01816"></a><span class="lineno"> 1816</span> </div>
<div class="line"><a id="l01817" name="l01817"></a><span class="lineno"> 1817</span>    <span class="keywordflow">if</span> (!found) {</div>
<div class="line"><a id="l01818" name="l01818"></a><span class="lineno"> 1818</span>      <span class="comment">// No expectation matches this call - reports a failure.</span></div>
<div class="line"><a id="l01819" name="l01819"></a><span class="lineno"> 1819</span>      Expect(<span class="keyword">false</span>, <span class="keyword">nullptr</span>, -1, ss.str());</div>
<div class="line"><a id="l01820" name="l01820"></a><span class="lineno"> 1820</span>    } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (is_excessive) {</div>
<div class="line"><a id="l01821" name="l01821"></a><span class="lineno"> 1821</span>      <span class="comment">// We had an upper-bound violation and the failure message is in ss.</span></div>
<div class="line"><a id="l01822" name="l01822"></a><span class="lineno"> 1822</span>      Expect(<span class="keyword">false</span>, untyped_expectation-&gt;file(), untyped_expectation-&gt;line(),</div>
<div class="line"><a id="l01823" name="l01823"></a><span class="lineno"> 1823</span>             ss.str());</div>
<div class="line"><a id="l01824" name="l01824"></a><span class="lineno"> 1824</span>    } <span class="keywordflow">else</span> {</div>
<div class="line"><a id="l01825" name="l01825"></a><span class="lineno"> 1825</span>      <span class="comment">// We had an expected call and the matching expectation is</span></div>
<div class="line"><a id="l01826" name="l01826"></a><span class="lineno"> 1826</span>      <span class="comment">// described in ss.</span></div>
<div class="line"><a id="l01827" name="l01827"></a><span class="lineno"> 1827</span>      Log(kInfo, loc.str() + ss.str(), 2);</div>
<div class="line"><a id="l01828" name="l01828"></a><span class="lineno"> 1828</span>    }</div>
<div class="line"><a id="l01829" name="l01829"></a><span class="lineno"> 1829</span>  });</div>
<div class="line"><a id="l01830" name="l01830"></a><span class="lineno"> 1830</span> </div>
<div class="line"><a id="l01831" name="l01831"></a><span class="lineno"> 1831</span>  <span class="keywordflow">return</span> PerformActionAndPrintResult(untyped_action, std::move(args), ss.str(),</div>
<div class="line"><a id="l01832" name="l01832"></a><span class="lineno"> 1832</span>                                     ss);</div>
<div class="line"><a id="l01833" name="l01833"></a><span class="lineno"> 1833</span>}</div>
<div class="line"><a id="l01834" name="l01834"></a><span class="lineno"> 1834</span> </div>
<div class="line"><a id="l01835" name="l01835"></a><span class="lineno"> 1835</span>}  <span class="comment">// namespace internal</span></div>
<div class="line"><a id="l01836" name="l01836"></a><span class="lineno"> 1836</span> </div>
<div class="line"><a id="l01837" name="l01837"></a><span class="lineno"> 1837</span><span class="keyword">namespace </span>internal {</div>
<div class="line"><a id="l01838" name="l01838"></a><span class="lineno"> 1838</span> </div>
<div class="line"><a id="l01839" name="l01839"></a><span class="lineno"> 1839</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l01840" name="l01840"></a><span class="lineno"> 1840</span><span class="keyword">class </span>MockFunction;</div>
<div class="line"><a id="l01841" name="l01841"></a><span class="lineno"> 1841</span> </div>
<div class="line"><a id="l01842" name="l01842"></a><span class="lineno"> 1842</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> R, <span class="keyword">typename</span>... Args&gt;</div>
<div class="line"><a id="l01843" name="l01843"></a><span class="lineno"> 1843</span><span class="keyword">class </span>MockFunction&lt;R(Args...)&gt; {</div>
<div class="line"><a id="l01844" name="l01844"></a><span class="lineno"> 1844</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01845" name="l01845"></a><span class="lineno"> 1845</span>  MockFunction(<span class="keyword">const</span> MockFunction&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01846" name="l01846"></a><span class="lineno"> 1846</span>  MockFunction&amp; operator=(<span class="keyword">const</span> MockFunction&amp;) = <span class="keyword">delete</span>;</div>
<div class="line"><a id="l01847" name="l01847"></a><span class="lineno"> 1847</span> </div>
<div class="line"><a id="l01848" name="l01848"></a><span class="lineno"> 1848</span>  std::function&lt;R(Args...)&gt; AsStdFunction() {</div>
<div class="line"><a id="l01849" name="l01849"></a><span class="lineno"> 1849</span>    <span class="keywordflow">return</span> [<span class="keyword">this</span>](Args... args) -&gt; R {</div>
<div class="line"><a id="l01850" name="l01850"></a><span class="lineno"> 1850</span>      <span class="keywordflow">return</span> this-&gt;Call(std::forward&lt;Args&gt;(args)...);</div>
<div class="line"><a id="l01851" name="l01851"></a><span class="lineno"> 1851</span>    };</div>
<div class="line"><a id="l01852" name="l01852"></a><span class="lineno"> 1852</span>  }</div>
<div class="line"><a id="l01853" name="l01853"></a><span class="lineno"> 1853</span> </div>
<div class="line"><a id="l01854" name="l01854"></a><span class="lineno"> 1854</span>  <span class="comment">// Implementation detail: the expansion of the MOCK_METHOD macro.</span></div>
<div class="line"><a id="l01855" name="l01855"></a><span class="lineno"> 1855</span>  R Call(Args... args) {</div>
<div class="line"><a id="l01856" name="l01856"></a><span class="lineno"> 1856</span>    mock_.SetOwnerAndName(<span class="keyword">this</span>, <span class="stringliteral">&quot;Call&quot;</span>);</div>
<div class="line"><a id="l01857" name="l01857"></a><span class="lineno"> 1857</span>    <span class="keywordflow">return</span> mock_.Invoke(std::forward&lt;Args&gt;(args)...);</div>
<div class="line"><a id="l01858" name="l01858"></a><span class="lineno"> 1858</span>  }</div>
<div class="line"><a id="l01859" name="l01859"></a><span class="lineno"> 1859</span> </div>
<div class="line"><a id="l01860" name="l01860"></a><span class="lineno"> 1860</span>  MockSpec&lt;R(Args...)&gt; gmock_Call(Matcher&lt;Args&gt;... m) {</div>
<div class="line"><a id="l01861" name="l01861"></a><span class="lineno"> 1861</span>    mock_.RegisterOwner(<span class="keyword">this</span>);</div>
<div class="line"><a id="l01862" name="l01862"></a><span class="lineno"> 1862</span>    <span class="keywordflow">return</span> mock_.With(std::move(m)...);</div>
<div class="line"><a id="l01863" name="l01863"></a><span class="lineno"> 1863</span>  }</div>
<div class="line"><a id="l01864" name="l01864"></a><span class="lineno"> 1864</span> </div>
<div class="line"><a id="l01865" name="l01865"></a><span class="lineno"> 1865</span>  MockSpec&lt;R(Args...)&gt; gmock_Call(<span class="keyword">const</span> WithoutMatchers&amp;, R (*)(Args...)) {</div>
<div class="line"><a id="l01866" name="l01866"></a><span class="lineno"> 1866</span>    <span class="keywordflow">return</span> this-&gt;gmock_Call(::testing::A&lt;Args&gt;()...);</div>
<div class="line"><a id="l01867" name="l01867"></a><span class="lineno"> 1867</span>  }</div>
<div class="line"><a id="l01868" name="l01868"></a><span class="lineno"> 1868</span> </div>
<div class="line"><a id="l01869" name="l01869"></a><span class="lineno"> 1869</span> <span class="keyword">protected</span>:</div>
<div class="line"><a id="l01870" name="l01870"></a><span class="lineno"> 1870</span>  MockFunction() = <span class="keywordflow">default</span>;</div>
<div class="line"><a id="l01871" name="l01871"></a><span class="lineno"> 1871</span>  ~MockFunction() = <span class="keywordflow">default</span>;</div>
<div class="line"><a id="l01872" name="l01872"></a><span class="lineno"> 1872</span> </div>
<div class="line"><a id="l01873" name="l01873"></a><span class="lineno"> 1873</span> <span class="keyword">private</span>:</div>
<div class="line"><a id="l01874" name="l01874"></a><span class="lineno"> 1874</span>  FunctionMocker&lt;R(Args...)&gt; mock_;</div>
<div class="line"><a id="l01875" name="l01875"></a><span class="lineno"> 1875</span>};</div>
<div class="line"><a id="l01876" name="l01876"></a><span class="lineno"> 1876</span> </div>
<div class="line"><a id="l01877" name="l01877"></a><span class="lineno"> 1877</span><span class="comment">/*</span></div>
<div class="line"><a id="l01878" name="l01878"></a><span class="lineno"> 1878</span><span class="comment">The SignatureOf&lt;F&gt; struct is a meta-function returning function signature</span></div>
<div class="line"><a id="l01879" name="l01879"></a><span class="lineno"> 1879</span><span class="comment">corresponding to the provided F argument.</span></div>
<div class="line"><a id="l01880" name="l01880"></a><span class="lineno"> 1880</span><span class="comment"></span> </div>
<div class="line"><a id="l01881" name="l01881"></a><span class="lineno"> 1881</span><span class="comment">It makes use of MockFunction easier by allowing it to accept more F arguments</span></div>
<div class="line"><a id="l01882" name="l01882"></a><span class="lineno"> 1882</span><span class="comment">than just function signatures.</span></div>
<div class="line"><a id="l01883" name="l01883"></a><span class="lineno"> 1883</span><span class="comment"></span> </div>
<div class="line"><a id="l01884" name="l01884"></a><span class="lineno"> 1884</span><span class="comment">Specializations provided here cover a signature type itself and any template</span></div>
<div class="line"><a id="l01885" name="l01885"></a><span class="lineno"> 1885</span><span class="comment">that can be parameterized with a signature, including std::function and</span></div>
<div class="line"><a id="l01886" name="l01886"></a><span class="lineno"> 1886</span><span class="comment">boost::function.</span></div>
<div class="line"><a id="l01887" name="l01887"></a><span class="lineno"> 1887</span><span class="comment">*/</span></div>
<div class="line"><a id="l01888" name="l01888"></a><span class="lineno"> 1888</span> </div>
<div class="line"><a id="l01889" name="l01889"></a><span class="lineno"> 1889</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> F, <span class="keyword">typename</span> = <span class="keywordtype">void</span>&gt;</div>
<div class="line"><a id="l01890" name="l01890"></a><span class="lineno"> 1890</span><span class="keyword">struct </span>SignatureOf;</div>
<div class="line"><a id="l01891" name="l01891"></a><span class="lineno"> 1891</span> </div>
<div class="line"><a id="l01892" name="l01892"></a><span class="lineno"> 1892</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> R, <span class="keyword">typename</span>... Args&gt;</div>
<div class="line"><a id="l01893" name="l01893"></a><span class="lineno"> 1893</span><span class="keyword">struct </span>SignatureOf&lt;R(Args...)&gt; {</div>
<div class="line"><a id="l01894" name="l01894"></a><span class="lineno"> 1894</span>  <span class="keyword">using </span>type = R(Args...);</div>
<div class="line"><a id="l01895" name="l01895"></a><span class="lineno"> 1895</span>};</div>
<div class="line"><a id="l01896" name="l01896"></a><span class="lineno"> 1896</span> </div>
<div class="line"><a id="l01897" name="l01897"></a><span class="lineno"> 1897</span><span class="keyword">template</span> &lt;<span class="keyword">template</span> &lt;<span class="keyword">typename</span>&gt; <span class="keyword">class </span>C, <span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l01898" name="l01898"></a><span class="lineno"> 1898</span><span class="keyword">struct </span>SignatureOf&lt;C&lt;F&gt;,</div>
<div class="line"><a id="l01899" name="l01899"></a><span class="lineno"> 1899</span>                   typename std::enable_if&lt;std::is_function&lt;F&gt;::value&gt;::type&gt;</div>
<div class="line"><a id="l01900" name="l01900"></a><span class="lineno"> 1900</span>    : SignatureOf&lt;F&gt; {};</div>
<div class="line"><a id="l01901" name="l01901"></a><span class="lineno"> 1901</span> </div>
<div class="line"><a id="l01902" name="l01902"></a><span class="lineno"> 1902</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l01903" name="l01903"></a><span class="lineno"> 1903</span><span class="keyword">using </span>SignatureOfT = <span class="keyword">typename</span> SignatureOf&lt;F&gt;::type;</div>
<div class="line"><a id="l01904" name="l01904"></a><span class="lineno"> 1904</span> </div>
<div class="line"><a id="l01905" name="l01905"></a><span class="lineno"> 1905</span>}  <span class="comment">// namespace internal</span></div>
<div class="line"><a id="l01906" name="l01906"></a><span class="lineno"> 1906</span> </div>
<div class="line"><a id="l01907" name="l01907"></a><span class="lineno"> 1907</span><span class="comment">// A MockFunction&lt;F&gt; type has one mock method whose type is</span></div>
<div class="line"><a id="l01908" name="l01908"></a><span class="lineno"> 1908</span><span class="comment">// internal::SignatureOfT&lt;F&gt;.  It is useful when you just want your</span></div>
<div class="line"><a id="l01909" name="l01909"></a><span class="lineno"> 1909</span><span class="comment">// test code to emit some messages and have Google Mock verify the</span></div>
<div class="line"><a id="l01910" name="l01910"></a><span class="lineno"> 1910</span><span class="comment">// right messages are sent (and perhaps at the right times).  For</span></div>
<div class="line"><a id="l01911" name="l01911"></a><span class="lineno"> 1911</span><span class="comment">// example, if you are exercising code:</span></div>
<div class="line"><a id="l01912" name="l01912"></a><span class="lineno"> 1912</span><span class="comment">//</span></div>
<div class="line"><a id="l01913" name="l01913"></a><span class="lineno"> 1913</span><span class="comment">//   Foo(1);</span></div>
<div class="line"><a id="l01914" name="l01914"></a><span class="lineno"> 1914</span><span class="comment">//   Foo(2);</span></div>
<div class="line"><a id="l01915" name="l01915"></a><span class="lineno"> 1915</span><span class="comment">//   Foo(3);</span></div>
<div class="line"><a id="l01916" name="l01916"></a><span class="lineno"> 1916</span><span class="comment">//</span></div>
<div class="line"><a id="l01917" name="l01917"></a><span class="lineno"> 1917</span><span class="comment">// and want to verify that Foo(1) and Foo(3) both invoke</span></div>
<div class="line"><a id="l01918" name="l01918"></a><span class="lineno"> 1918</span><span class="comment">// mock.Bar(&quot;a&quot;), but Foo(2) doesn&#39;t invoke anything, you can write:</span></div>
<div class="line"><a id="l01919" name="l01919"></a><span class="lineno"> 1919</span><span class="comment">//</span></div>
<div class="line"><a id="l01920" name="l01920"></a><span class="lineno"> 1920</span><span class="comment">// TEST(FooTest, InvokesBarCorrectly) {</span></div>
<div class="line"><a id="l01921" name="l01921"></a><span class="lineno"> 1921</span><span class="comment">//   MyMock mock;</span></div>
<div class="line"><a id="l01922" name="l01922"></a><span class="lineno"> 1922</span><span class="comment">//   MockFunction&lt;void(string check_point_name)&gt; check;</span></div>
<div class="line"><a id="l01923" name="l01923"></a><span class="lineno"> 1923</span><span class="comment">//   {</span></div>
<div class="line"><a id="l01924" name="l01924"></a><span class="lineno"> 1924</span><span class="comment">//     InSequence s;</span></div>
<div class="line"><a id="l01925" name="l01925"></a><span class="lineno"> 1925</span><span class="comment">//</span></div>
<div class="line"><a id="l01926" name="l01926"></a><span class="lineno"> 1926</span><span class="comment">//     EXPECT_CALL(mock, Bar(&quot;a&quot;));</span></div>
<div class="line"><a id="l01927" name="l01927"></a><span class="lineno"> 1927</span><span class="comment">//     EXPECT_CALL(check, Call(&quot;1&quot;));</span></div>
<div class="line"><a id="l01928" name="l01928"></a><span class="lineno"> 1928</span><span class="comment">//     EXPECT_CALL(check, Call(&quot;2&quot;));</span></div>
<div class="line"><a id="l01929" name="l01929"></a><span class="lineno"> 1929</span><span class="comment">//     EXPECT_CALL(mock, Bar(&quot;a&quot;));</span></div>
<div class="line"><a id="l01930" name="l01930"></a><span class="lineno"> 1930</span><span class="comment">//   }</span></div>
<div class="line"><a id="l01931" name="l01931"></a><span class="lineno"> 1931</span><span class="comment">//   Foo(1);</span></div>
<div class="line"><a id="l01932" name="l01932"></a><span class="lineno"> 1932</span><span class="comment">//   check.Call(&quot;1&quot;);</span></div>
<div class="line"><a id="l01933" name="l01933"></a><span class="lineno"> 1933</span><span class="comment">//   Foo(2);</span></div>
<div class="line"><a id="l01934" name="l01934"></a><span class="lineno"> 1934</span><span class="comment">//   check.Call(&quot;2&quot;);</span></div>
<div class="line"><a id="l01935" name="l01935"></a><span class="lineno"> 1935</span><span class="comment">//   Foo(3);</span></div>
<div class="line"><a id="l01936" name="l01936"></a><span class="lineno"> 1936</span><span class="comment">// }</span></div>
<div class="line"><a id="l01937" name="l01937"></a><span class="lineno"> 1937</span><span class="comment">//</span></div>
<div class="line"><a id="l01938" name="l01938"></a><span class="lineno"> 1938</span><span class="comment">// The expectation spec says that the first Bar(&quot;a&quot;) must happen</span></div>
<div class="line"><a id="l01939" name="l01939"></a><span class="lineno"> 1939</span><span class="comment">// before check point &quot;1&quot;, the second Bar(&quot;a&quot;) must happen after check</span></div>
<div class="line"><a id="l01940" name="l01940"></a><span class="lineno"> 1940</span><span class="comment">// point &quot;2&quot;, and nothing should happen between the two check</span></div>
<div class="line"><a id="l01941" name="l01941"></a><span class="lineno"> 1941</span><span class="comment">// points. The explicit check points make it easy to tell which</span></div>
<div class="line"><a id="l01942" name="l01942"></a><span class="lineno"> 1942</span><span class="comment">// Bar(&quot;a&quot;) is called by which call to Foo().</span></div>
<div class="line"><a id="l01943" name="l01943"></a><span class="lineno"> 1943</span><span class="comment">//</span></div>
<div class="line"><a id="l01944" name="l01944"></a><span class="lineno"> 1944</span><span class="comment">// MockFunction&lt;F&gt; can also be used to exercise code that accepts</span></div>
<div class="line"><a id="l01945" name="l01945"></a><span class="lineno"> 1945</span><span class="comment">// std::function&lt;internal::SignatureOfT&lt;F&gt;&gt; callbacks. To do so, use</span></div>
<div class="line"><a id="l01946" name="l01946"></a><span class="lineno"> 1946</span><span class="comment">// AsStdFunction() method to create std::function proxy forwarding to</span></div>
<div class="line"><a id="l01947" name="l01947"></a><span class="lineno"> 1947</span><span class="comment">// original object&#39;s Call. Example:</span></div>
<div class="line"><a id="l01948" name="l01948"></a><span class="lineno"> 1948</span><span class="comment">//</span></div>
<div class="line"><a id="l01949" name="l01949"></a><span class="lineno"> 1949</span><span class="comment">// TEST(FooTest, RunsCallbackWithBarArgument) {</span></div>
<div class="line"><a id="l01950" name="l01950"></a><span class="lineno"> 1950</span><span class="comment">//   MockFunction&lt;int(string)&gt; callback;</span></div>
<div class="line"><a id="l01951" name="l01951"></a><span class="lineno"> 1951</span><span class="comment">//   EXPECT_CALL(callback, Call(&quot;bar&quot;)).WillOnce(Return(1));</span></div>
<div class="line"><a id="l01952" name="l01952"></a><span class="lineno"> 1952</span><span class="comment">//   Foo(callback.AsStdFunction());</span></div>
<div class="line"><a id="l01953" name="l01953"></a><span class="lineno"> 1953</span><span class="comment">// }</span></div>
<div class="line"><a id="l01954" name="l01954"></a><span class="lineno"> 1954</span><span class="comment">//</span></div>
<div class="line"><a id="l01955" name="l01955"></a><span class="lineno"> 1955</span><span class="comment">// The internal::SignatureOfT&lt;F&gt; indirection allows to use other types</span></div>
<div class="line"><a id="l01956" name="l01956"></a><span class="lineno"> 1956</span><span class="comment">// than just function signature type. This is typically useful when</span></div>
<div class="line"><a id="l01957" name="l01957"></a><span class="lineno"> 1957</span><span class="comment">// providing a mock for a predefined std::function type. Example:</span></div>
<div class="line"><a id="l01958" name="l01958"></a><span class="lineno"> 1958</span><span class="comment">//</span></div>
<div class="line"><a id="l01959" name="l01959"></a><span class="lineno"> 1959</span><span class="comment">// using FilterPredicate = std::function&lt;bool(string)&gt;;</span></div>
<div class="line"><a id="l01960" name="l01960"></a><span class="lineno"> 1960</span><span class="comment">// void MyFilterAlgorithm(FilterPredicate predicate);</span></div>
<div class="line"><a id="l01961" name="l01961"></a><span class="lineno"> 1961</span><span class="comment">//</span></div>
<div class="line"><a id="l01962" name="l01962"></a><span class="lineno"> 1962</span><span class="comment">// TEST(FooTest, FilterPredicateAlwaysAccepts) {</span></div>
<div class="line"><a id="l01963" name="l01963"></a><span class="lineno"> 1963</span><span class="comment">//   MockFunction&lt;FilterPredicate&gt; predicateMock;</span></div>
<div class="line"><a id="l01964" name="l01964"></a><span class="lineno"> 1964</span><span class="comment">//   EXPECT_CALL(predicateMock, Call(_)).WillRepeatedly(Return(true));</span></div>
<div class="line"><a id="l01965" name="l01965"></a><span class="lineno"> 1965</span><span class="comment">//   MyFilterAlgorithm(predicateMock.AsStdFunction());</span></div>
<div class="line"><a id="l01966" name="l01966"></a><span class="lineno"> 1966</span><span class="comment">// }</span></div>
<div class="line"><a id="l01967" name="l01967"></a><span class="lineno"> 1967</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> F&gt;</div>
<div class="line"><a id="l01968" name="l01968"></a><span class="lineno"> 1968</span><span class="keyword">class </span>MockFunction : <span class="keyword">public</span> internal::MockFunction&lt;internal::SignatureOfT&lt;F&gt;&gt; {</div>
<div class="line"><a id="l01969" name="l01969"></a><span class="lineno"> 1969</span>  <span class="keyword">using </span>Base = internal::MockFunction&lt;internal::SignatureOfT&lt;F&gt;&gt;;</div>
<div class="line"><a id="l01970" name="l01970"></a><span class="lineno"> 1970</span> </div>
<div class="line"><a id="l01971" name="l01971"></a><span class="lineno"> 1971</span> <span class="keyword">public</span>:</div>
<div class="line"><a id="l01972" name="l01972"></a><span class="lineno"> 1972</span>  <span class="keyword">using </span>Base::Base;</div>
<div class="line"><a id="l01973" name="l01973"></a><span class="lineno"> 1973</span>};</div>
<div class="line"><a id="l01974" name="l01974"></a><span class="lineno"> 1974</span> </div>
<div class="line"><a id="l01975" name="l01975"></a><span class="lineno"> 1975</span><span class="comment">// The style guide prohibits &quot;using&quot; statements in a namespace scope</span></div>
<div class="line"><a id="l01976" name="l01976"></a><span class="lineno"> 1976</span><span class="comment">// inside a header file.  However, the MockSpec class template is</span></div>
<div class="line"><a id="l01977" name="l01977"></a><span class="lineno"> 1977</span><span class="comment">// meant to be defined in the ::testing namespace.  The following line</span></div>
<div class="line"><a id="l01978" name="l01978"></a><span class="lineno"> 1978</span><span class="comment">// is just a trick for working around a bug in MSVC 8.0, which cannot</span></div>
<div class="line"><a id="l01979" name="l01979"></a><span class="lineno"> 1979</span><span class="comment">// handle it if we define MockSpec in ::testing.</span></div>
<div class="line"><a id="l01980" name="l01980"></a><span class="lineno"> 1980</span><span class="keyword">using </span>internal::MockSpec;</div>
<div class="line"><a id="l01981" name="l01981"></a><span class="lineno"> 1981</span> </div>
<div class="line"><a id="l01982" name="l01982"></a><span class="lineno"> 1982</span><span class="comment">// Const(x) is a convenient function for obtaining a const reference</span></div>
<div class="line"><a id="l01983" name="l01983"></a><span class="lineno"> 1983</span><span class="comment">// to x.  This is useful for setting expectations on an overloaded</span></div>
<div class="line"><a id="l01984" name="l01984"></a><span class="lineno"> 1984</span><span class="comment">// const mock method, e.g.</span></div>
<div class="line"><a id="l01985" name="l01985"></a><span class="lineno"> 1985</span><span class="comment">//</span></div>
<div class="line"><a id="l01986" name="l01986"></a><span class="lineno"> 1986</span><span class="comment">//   class MockFoo : public FooInterface {</span></div>
<div class="line"><a id="l01987" name="l01987"></a><span class="lineno"> 1987</span><span class="comment">//    public:</span></div>
<div class="line"><a id="l01988" name="l01988"></a><span class="lineno"> 1988</span><span class="comment">//     MOCK_METHOD0(Bar, int());</span></div>
<div class="line"><a id="l01989" name="l01989"></a><span class="lineno"> 1989</span><span class="comment">//     MOCK_CONST_METHOD0(Bar, int&amp;());</span></div>
<div class="line"><a id="l01990" name="l01990"></a><span class="lineno"> 1990</span><span class="comment">//   };</span></div>
<div class="line"><a id="l01991" name="l01991"></a><span class="lineno"> 1991</span><span class="comment">//</span></div>
<div class="line"><a id="l01992" name="l01992"></a><span class="lineno"> 1992</span><span class="comment">//   MockFoo foo;</span></div>
<div class="line"><a id="l01993" name="l01993"></a><span class="lineno"> 1993</span><span class="comment">//   // Expects a call to non-const MockFoo::Bar().</span></div>
<div class="line"><a id="l01994" name="l01994"></a><span class="lineno"> 1994</span><span class="comment">//   EXPECT_CALL(foo, Bar());</span></div>
<div class="line"><a id="l01995" name="l01995"></a><span class="lineno"> 1995</span><span class="comment">//   // Expects a call to const MockFoo::Bar().</span></div>
<div class="line"><a id="l01996" name="l01996"></a><span class="lineno"> 1996</span><span class="comment">//   EXPECT_CALL(Const(foo), Bar());</span></div>
<div class="line"><a id="l01997" name="l01997"></a><span class="lineno"> 1997</span><span class="keyword">template</span> &lt;<span class="keyword">typename</span> T&gt;</div>
<div class="line"><a id="l01998" name="l01998"></a><span class="lineno"> 1998</span><span class="keyword">inline</span> <span class="keyword">const</span> T&amp; Const(<span class="keyword">const</span> T&amp; x) {</div>
<div class="line"><a id="l01999" name="l01999"></a><span class="lineno"> 1999</span>  <span class="keywordflow">return</span> x;</div>
<div class="line"><a id="l02000" name="l02000"></a><span class="lineno"> 2000</span>}</div>
<div class="line"><a id="l02001" name="l02001"></a><span class="lineno"> 2001</span> </div>
<div class="line"><a id="l02002" name="l02002"></a><span class="lineno"> 2002</span><span class="comment">// Constructs an Expectation object that references and co-owns exp.</span></div>
<div class="line"><a id="l02003" name="l02003"></a><span class="lineno"> 2003</span><span class="keyword">inline</span> Expectation::Expectation(internal::ExpectationBase&amp; exp)  <span class="comment">// NOLINT</span></div>
<div class="line"><a id="l02004" name="l02004"></a><span class="lineno"> 2004</span>    : expectation_base_(exp.GetHandle().expectation_base()) {}</div>
<div class="line"><a id="l02005" name="l02005"></a><span class="lineno"> 2005</span> </div>
<div class="line"><a id="l02006" name="l02006"></a><span class="lineno"> 2006</span>}  <span class="comment">// namespace testing</span></div>
<div class="line"><a id="l02007" name="l02007"></a><span class="lineno"> 2007</span> </div>
<div class="line"><a id="l02008" name="l02008"></a><span class="lineno"> 2008</span>GTEST_DISABLE_MSC_WARNINGS_POP_()  <span class="comment">//  4251</span></div>
<div class="line"><a id="l02009" name="l02009"></a><span class="lineno"> 2009</span> </div>
<div class="line"><a id="l02010" name="l02010"></a><span class="lineno"> 2010</span><span class="comment">// Implementation for ON_CALL and EXPECT_CALL macros. A separate macro is</span></div>
<div class="line"><a id="l02011" name="l02011"></a><span class="lineno"> 2011</span><span class="comment">// required to avoid compile errors when the name of the method used in call is</span></div>
<div class="line"><a id="l02012" name="l02012"></a><span class="lineno"> 2012</span><span class="comment">// a result of macro expansion. See CompilesWithMethodNameExpandedFromMacro</span></div>
<div class="line"><a id="l02013" name="l02013"></a><span class="lineno"> 2013</span><span class="comment">// tests in internal/gmock-spec-builders_test.cc for more details.</span></div>
<div class="line"><a id="l02014" name="l02014"></a><span class="lineno"> 2014</span><span class="comment">//</span></div>
<div class="line"><a id="l02015" name="l02015"></a><span class="lineno"> 2015</span><span class="comment">// This macro supports statements both with and without parameter matchers. If</span></div>
<div class="line"><a id="l02016" name="l02016"></a><span class="lineno"> 2016</span><span class="comment">// the parameter list is omitted, gMock will accept any parameters, which allows</span></div>
<div class="line"><a id="l02017" name="l02017"></a><span class="lineno"> 2017</span><span class="comment">// tests to be written that don&#39;t need to encode the number of method</span></div>
<div class="line"><a id="l02018" name="l02018"></a><span class="lineno"> 2018</span><span class="comment">// parameter. This technique may only be used for non-overloaded methods.</span></div>
<div class="line"><a id="l02019" name="l02019"></a><span class="lineno"> 2019</span><span class="comment">//</span></div>
<div class="line"><a id="l02020" name="l02020"></a><span class="lineno"> 2020</span><span class="comment">//   // These are the same:</span></div>
<div class="line"><a id="l02021" name="l02021"></a><span class="lineno"> 2021</span><span class="comment">//   ON_CALL(mock, NoArgsMethod()).WillByDefault(...);</span></div>
<div class="line"><a id="l02022" name="l02022"></a><span class="lineno"> 2022</span><span class="comment">//   ON_CALL(mock, NoArgsMethod).WillByDefault(...);</span></div>
<div class="line"><a id="l02023" name="l02023"></a><span class="lineno"> 2023</span><span class="comment">//</span></div>
<div class="line"><a id="l02024" name="l02024"></a><span class="lineno"> 2024</span><span class="comment">//   // As are these:</span></div>
<div class="line"><a id="l02025" name="l02025"></a><span class="lineno"> 2025</span><span class="comment">//   ON_CALL(mock, TwoArgsMethod(_, _)).WillByDefault(...);</span></div>
<div class="line"><a id="l02026" name="l02026"></a><span class="lineno"> 2026</span><span class="comment">//   ON_CALL(mock, TwoArgsMethod).WillByDefault(...);</span></div>
<div class="line"><a id="l02027" name="l02027"></a><span class="lineno"> 2027</span><span class="comment">//</span></div>
<div class="line"><a id="l02028" name="l02028"></a><span class="lineno"> 2028</span><span class="comment">//   // Can also specify args if you want, of course:</span></div>
<div class="line"><a id="l02029" name="l02029"></a><span class="lineno"> 2029</span><span class="comment">//   ON_CALL(mock, TwoArgsMethod(_, 45)).WillByDefault(...);</span></div>
<div class="line"><a id="l02030" name="l02030"></a><span class="lineno"> 2030</span><span class="comment">//</span></div>
<div class="line"><a id="l02031" name="l02031"></a><span class="lineno"> 2031</span><span class="comment">//   // Overloads work as long as you specify parameters:</span></div>
<div class="line"><a id="l02032" name="l02032"></a><span class="lineno"> 2032</span><span class="comment">//   ON_CALL(mock, OverloadedMethod(_)).WillByDefault(...);</span></div>
<div class="line"><a id="l02033" name="l02033"></a><span class="lineno"> 2033</span><span class="comment">//   ON_CALL(mock, OverloadedMethod(_, _)).WillByDefault(...);</span></div>
<div class="line"><a id="l02034" name="l02034"></a><span class="lineno"> 2034</span><span class="comment">//</span></div>
<div class="line"><a id="l02035" name="l02035"></a><span class="lineno"> 2035</span><span class="comment">//   // Oops! Which overload did you want?</span></div>
<div class="line"><a id="l02036" name="l02036"></a><span class="lineno"> 2036</span><span class="comment">//   ON_CALL(mock, OverloadedMethod).WillByDefault(...);</span></div>
<div class="line"><a id="l02037" name="l02037"></a><span class="lineno"> 2037</span><span class="comment">//     =&gt; ERROR: call to member function &#39;gmock_OverloadedMethod&#39; is ambiguous</span></div>
<div class="line"><a id="l02038" name="l02038"></a><span class="lineno"> 2038</span><span class="comment">//</span></div>
<div class="line"><a id="l02039" name="l02039"></a><span class="lineno"> 2039</span><span class="comment">// How this works: The mock class uses two overloads of the gmock_Method</span></div>
<div class="line"><a id="l02040" name="l02040"></a><span class="lineno"> 2040</span><span class="comment">// expectation setter method plus an operator() overload on the MockSpec object.</span></div>
<div class="line"><a id="l02041" name="l02041"></a><span class="lineno"> 2041</span><span class="comment">// In the matcher list form, the macro expands to:</span></div>
<div class="line"><a id="l02042" name="l02042"></a><span class="lineno"> 2042</span><span class="comment">//</span></div>
<div class="line"><a id="l02043" name="l02043"></a><span class="lineno"> 2043</span><span class="comment">//   // This statement:</span></div>
<div class="line"><a id="l02044" name="l02044"></a><span class="lineno"> 2044</span><span class="comment">//   ON_CALL(mock, TwoArgsMethod(_, 45))...</span></div>
<div class="line"><a id="l02045" name="l02045"></a><span class="lineno"> 2045</span><span class="comment">//</span></div>
<div class="line"><a id="l02046" name="l02046"></a><span class="lineno"> 2046</span><span class="comment">//   // ...expands to:</span></div>
<div class="line"><a id="l02047" name="l02047"></a><span class="lineno"> 2047</span><span class="comment">//   mock.gmock_TwoArgsMethod(_, 45)(WithoutMatchers(), nullptr)...</span></div>
<div class="line"><a id="l02048" name="l02048"></a><span class="lineno"> 2048</span><span class="comment">//   |-------------v---------------||------------v-------------|</span></div>
<div class="line"><a id="l02049" name="l02049"></a><span class="lineno"> 2049</span><span class="comment">//       invokes first overload        swallowed by operator()</span></div>
<div class="line"><a id="l02050" name="l02050"></a><span class="lineno"> 2050</span><span class="comment">//</span></div>
<div class="line"><a id="l02051" name="l02051"></a><span class="lineno"> 2051</span><span class="comment">//   // ...which is essentially:</span></div>
<div class="line"><a id="l02052" name="l02052"></a><span class="lineno"> 2052</span><span class="comment">//   mock.gmock_TwoArgsMethod(_, 45)...</span></div>
<div class="line"><a id="l02053" name="l02053"></a><span class="lineno"> 2053</span><span class="comment">//</span></div>
<div class="line"><a id="l02054" name="l02054"></a><span class="lineno"> 2054</span><span class="comment">// Whereas the form without a matcher list:</span></div>
<div class="line"><a id="l02055" name="l02055"></a><span class="lineno"> 2055</span><span class="comment">//</span></div>
<div class="line"><a id="l02056" name="l02056"></a><span class="lineno"> 2056</span><span class="comment">//   // This statement:</span></div>
<div class="line"><a id="l02057" name="l02057"></a><span class="lineno"> 2057</span><span class="comment">//   ON_CALL(mock, TwoArgsMethod)...</span></div>
<div class="line"><a id="l02058" name="l02058"></a><span class="lineno"> 2058</span><span class="comment">//</span></div>
<div class="line"><a id="l02059" name="l02059"></a><span class="lineno"> 2059</span><span class="comment">//   // ...expands to:</span></div>
<div class="line"><a id="l02060" name="l02060"></a><span class="lineno"> 2060</span><span class="comment">//   mock.gmock_TwoArgsMethod(WithoutMatchers(), nullptr)...</span></div>
<div class="line"><a id="l02061" name="l02061"></a><span class="lineno"> 2061</span><span class="comment">//   |-----------------------v--------------------------|</span></div>
<div class="line"><a id="l02062" name="l02062"></a><span class="lineno"> 2062</span><span class="comment">//                 invokes second overload</span></div>
<div class="line"><a id="l02063" name="l02063"></a><span class="lineno"> 2063</span><span class="comment">//</span></div>
<div class="line"><a id="l02064" name="l02064"></a><span class="lineno"> 2064</span><span class="comment">//   // ...which is essentially:</span></div>
<div class="line"><a id="l02065" name="l02065"></a><span class="lineno"> 2065</span><span class="comment">//   mock.gmock_TwoArgsMethod(_, _)...</span></div>
<div class="line"><a id="l02066" name="l02066"></a><span class="lineno"> 2066</span><span class="comment">//</span></div>
<div class="line"><a id="l02067" name="l02067"></a><span class="lineno"> 2067</span><span class="comment">// The WithoutMatchers() argument is used to disambiguate overloads and to</span></div>
<div class="line"><a id="l02068" name="l02068"></a><span class="lineno"> 2068</span><span class="comment">// block the caller from accidentally invoking the second overload directly. The</span></div>
<div class="line"><a id="l02069" name="l02069"></a><span class="lineno"> 2069</span><span class="comment">// second argument is an internal type derived from the method signature. The</span></div>
<div class="line"><a id="l02070" name="l02070"></a><span class="lineno"> 2070</span><span class="comment">// failure to disambiguate two overloads of this method in the ON_CALL statement</span></div>
<div class="line"><a id="l02071" name="l02071"></a><span class="lineno"> 2071</span><span class="comment">// is how we block callers from setting expectations on overloaded methods.</span></div>
<div class="line"><a id="l02072" name="l02072"></a><span class="lineno"> 2072</span><span class="preprocessor">#define GMOCK_ON_CALL_IMPL_(mock_expr, Setter, call)                    \</span></div>
<div class="line"><a id="l02073" name="l02073"></a><span class="lineno"> 2073</span><span class="preprocessor">  ((mock_expr).gmock_##call)(::testing::internal::GetWithoutMatchers(), \</span></div>
<div class="line"><a id="l02074" name="l02074"></a><span class="lineno"> 2074</span><span class="preprocessor">                             nullptr)                                   \</span></div>
<div class="line"><a id="l02075" name="l02075"></a><span class="lineno"> 2075</span><span class="preprocessor">      .Setter(__FILE__, __LINE__, #mock_expr, #call)</span></div>
<div class="line"><a id="l02076" name="l02076"></a><span class="lineno"> 2076</span> </div>
<div class="line"><a id="l02077" name="l02077"></a><span class="lineno"> 2077</span><span class="preprocessor">#define ON_CALL(obj, call) \</span></div>
<div class="line"><a id="l02078" name="l02078"></a><span class="lineno"> 2078</span><span class="preprocessor">  GMOCK_ON_CALL_IMPL_(obj, InternalDefaultActionSetAt, call)</span></div>
<div class="line"><a id="l02079" name="l02079"></a><span class="lineno"> 2079</span> </div>
<div class="line"><a id="l02080" name="l02080"></a><span class="lineno"> 2080</span><span class="preprocessor">#define EXPECT_CALL(obj, call) \</span></div>
<div class="line"><a id="l02081" name="l02081"></a><span class="lineno"> 2081</span><span class="preprocessor">  GMOCK_ON_CALL_IMPL_(obj, InternalExpectedAt, call)</span></div>
<div class="line"><a id="l02082" name="l02082"></a><span class="lineno"> 2082</span> </div>
<div class="line"><a id="l02083" name="l02083"></a><span class="lineno"> 2083</span><span class="preprocessor">#endif  </span><span class="comment">// GOOGLEMOCK_INCLUDE_GMOCK_GMOCK_SPEC_BUILDERS_H_</span></div>
</div><!-- fragment --></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
  <ul>
    <li class="navelem"><a class="el" href="dir_4335ce4a64d0d4f9f4c8f0a782dfdfeb.html">Build</a></li><li class="navelem"><a class="el" href="dir_52591f05075520724bd5e6f6d1d2f7f0.html">_deps</a></li><li class="navelem"><a class="el" href="dir_f332dbc5c9861f18ba978cecf6e1ca1f.html">googletest-src</a></li><li class="navelem"><a class="el" href="dir_1ac9694ea1a0831311ad14362c25b5b7.html">googlemock</a></li><li class="navelem"><a class="el" href="dir_89d0e55e91f69962a3e059d7cdfa8987.html">include</a></li><li class="navelem"><a class="el" href="dir_110122aa0820cd6e27cdd82e2769d067.html">gmock</a></li><li class="navelem"><b>gmock-spec-builders.h</b></li>
    <li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.13.2 </li>
  </ul>
</div>
</body>
</html>
